Obsidian 周日志模板实战:Weekly Log V2 的结构拆解、字段设计与核心插件用法
Obsidian 周日志模板实战:Weekly Log V2 的结构拆解、字段设计与核心插件用法
OB_Templates 是一个面向 Obsidian 新用户、坚持"只用核心插件"原则的模板参考仓库,其中 0A_1_9_WeeklyLog_V2.md 是日志体系里的"周日志 V2"模板:它用一张六维追踪表 + 五个复盘板块,把一周的日常记录压缩成一页可快速回看的周报。本文将逐行拆解该模板的 YAML Frontmatter、动态目录、ISO 周数标题、追踪表字段与复盘板块的设计意图,并对照仓库内配套的 Daily Log V2 与 Weekly Log V1,讲清楚如何把它接入你的 Vault,以及怎样按自己的习惯改造它。
一、模板定位:OB_Templates 日志体系中的 Weekly Log V2
在动手使用模板之前,先弄清它在这个仓库中的位置和设计语境。
1.1 项目背景与核心规则
根据 README.md 的项目说明,OB_Templates 是一个自 2021 年底开始维护的 Obsidian 模板仓库,目标是帮助新用户快速搭建个人笔记体系,并遵循一条硬性规则:所有模板只使用 Obsidian 核心插件。虽然仓库作者在 README 中承认 DataView 已成为许多用户的"必需品",但模板本体始终尽量保持基础,避免吓跑新用户。
本模板位于 0A_Templates/0A_1_Logs/ 目录,属于"Logs(日志)"模板家族。README 将该家族概括为"Templates for daily log, weekly, monthly and yearly reviews",即覆盖日、周、月、年四个时间粒度的记录与复盘。Weekly Log V2 承担的就是周粒度那一环。
1.2 文件名里的命名约定
仓库 README.md 的 File Structure 一节解释了这套 0A 前缀命名法:
- 所有文件夹以
0开头(因为这是作者的根笔记体系,值为 0),后跟一个字母表示主分支(如A表示第一个 Vault 文件夹); - 文件编号携带层级信息:
0A_1_1_DailyLog= 根文件夹 0 → 一级文件夹 A → 子文件夹序号 1(Logs)→ 文件序号 1 → 文件名 DailyLog。
按此规则,0A_1_9_WeeklyLog_V2 即:根文件夹 0A → Logs 子文件夹(序号 1)→ 第 9 个日志模板文件 → 周日志(WeeklyLog)→ 第 2 版(V2)。整份 0A_Index.md 索引也沿用了同一套编号逻辑,把 Daily、Weekly、Monthly、Yearly 系列串成一条日志链路。
二、模板全景:完整结构与区块职责
先完整呈现模板原文(共 27 行),再逐块拆解。该文件实际内容如下:
---
created: ["{{date}} {{time}}"]
tags:
- Log/WeeklLog
---
___
```toc
style: number
🌌 Overview -> Week Report -> Week {{date:ww}}
🍜 - Breakfast |✨ - Feeling |✏️ - Working On 💲 - Money Spent |💪 -Workout |📈 Motivation
| Day | 🍜 | ✨ | ✏️ | 💲 | 💪 | 📈 |
|---|---|---|---|---|---|---|
📑 Got Done This Week
🔃 Need to Work On
📜 Events
📃 Projects
💾 Information to retain
按行号可以把模板划分为六个功能区块:
| 行号 | 区块 | 作用 |
| --- | --- | --- |
| L1–L5 | YAML Frontmatter | 记录创建时间、声明日志标签 |
| L6 | `___` 分隔线 | 视觉上分隔元数据与正文 |
| L7–L9 | `toc` 代码块 | 生成带编号的动态目录 |
| L10 | H1 标题 | 标题自动带出当前 ISO 周数 |
| L11–L12 | 图例行 | 定义表格六个 emoji 维度的含义 |
| L14–L16 | 周追踪表 | 按天记录六个日常维度 |
| L17–L27 | 五个复盘板块 | 完成项、待改进、事件、项目、留存信息 |
接下来按区块逐一深入。
## 三、YAML Frontmatter:动态创建时间与日志标签
模板开头是 5 行 Frontmatter(对应 <a href="https://link.gitcode.com/i/47a6ff875691e57bb4166ab53d528782" target="_blank">0A_1_9_WeeklyLog_V2.md</a>):
created: ["{{date}} {{time}}"] tags:
- Log/WeeklLog
两个字段各有讲究:
**created 使用数组形式**。`created: <a href="https://link.gitcode.com/i/68b0bf456d596ba762978dbcaab57673" target="_blank">"{{date}} {{time}}"]` 中的 `{{date}}` 与 `{{time}}` 是 Obsidian 核心模板功能的占位符,在通过"Templates 核心插件"插入模板时会被自动替换为当前日期与时间(README FAQ 中也强调:"make sure you have at least Obsidian native templates option enabled and configured",即至少启用并配置好 Obsidian 原生模板功能)。外层用 `["..."]` 包裹成数组,与仓库中 V1 周日志 [0A_1_6_WeeklyLog.md</a> 的写法保持一致,也方便后续用插件或查询读取该属性。
**tags 使用层级标签**。`Log/WeeklLog` 表示这是一个属于 Log 大类、WeeklLog 子类的日志。需要留意的是,这里写作 `WeeklLog`("Weekly" 的省略拼写),而 V1 模板 <a href="https://link.gitcode.com/i/8c43060e6ac283ee9f488be3531ad816" target="_blank">0A_1_6_WeeklyLog.md</a> 与 <a href="https://link.gitcode.com/i/811fd24f1080248bf03852646960c779" target="_blank">0A_1_8_WeeklyReview_V2.md</a> 都写作 `Log/WeeklyLog`,拼写并不统一。README 的 FAQ 明确说明:"All the Tags in the templates are just examples. You can add or remove any Tags you would like"——标签只是示例,你可以自由增删。**建议实际使用时统一成 `Log/WeeklyLog` 之类的拼写**,否则不同周日志文件之间无法通过同一个标签聚合检索。
## 四、动态目录与周数标题
### 4.1 `toc` 代码块:动态编号目录
模板第 7–9 行是动态目录配置:
style: number
这个 `toc` 代码块来自社区插件 **Dynamic Table of Contents**(README 的 FAQ 中将其列为推荐安装项,原文为"it does not hurt to have Dynamic Table of Contents")。`style: number` 表示目录以数字编号列表呈现。该插件会扫描当前笔记的标题层级,自动生成可点击跳转的目录。
需要注意插件依赖边界:仓库的"只用核心插件"规则并不包含这个社区插件,因此**该代码块只有在安装了 Dynamic Table of Contents 时才会渲染为目录**;未安装时它会退化为普通代码块原样显示,但模板其余部分(Frontmatter、表格、复盘板块)依然可以正常使用——这也是该模板"降级友好"的设计。
### 4.2 `{{date:ww}}`:把 ISO 周数写进标题
模板标题(<a href="https://link.gitcode.com/i/c5023525d590beac1579fe1e407da38d" target="_blank">0A_1_9_WeeklyLog_V2.md</a>)为:
🌌 Overview -> Week Report -> Week {{date:ww}}
其中 `{{date:ww}}` 是模板占位符的自定义格式用法:Obsidian 模板语法的日期格式沿用 Moment.js 风格 token,`ww` 对应 **ISO 周数(ISO week of year,取值 01–53)**。插入模板时它会自动替换为当前周数,例如第 41 周会渲染为 `Week 41`。
标题的语义链 `Overview -> Week Report -> Week 41` 也体现了作者的笔记组织思路:先进入 Overview(总览)视图,再定位到周报(Week Report),最后落到具体周次。配合 Obsidian 的标签/反链功能,这种"按周编号命名"的标题天然具备时间排序能力。
## 五、周追踪表:六个维度的"一眼周报"
这是模板的信息密度核心,对应 <a href="https://link.gitcode.com/i/9ad4466d1c3ae083914f562e56936153" target="_blank">0A_1_9_WeeklyLog_V2.md</a>:
🍜 - Breakfast |✨ - Feeling |✏️ - Working On 💲 - Money Spent |💪 -Workout |📈 Motivation
| Day | 🍜 | ✨ | ✏️ | 💲 | 💪 | 📈 |
|---|---|---|---|---|---|---|
### 5.1 图例:六个 emoji 维度的含义
表头上方的两行图例定义了六个维度:
- 🍜 = Breakfast(早餐)
- ✨ = Feeling(心情/感受)
- ✏️ = Working On(正在做的事)
- 💲 = Money Spent(花销)
- 💪 = Workout(锻炼)
- 📈 = Motivation(动力)
这套字段不是随意拍的。对照仓库内配套的日日志模板 <a href="https://link.gitcode.com/i/1cd0b2429134e698281ce35038cceaa5" target="_blank">0A_1_7_DailyLog_V2.md</a>,其 Tracker 板块定义的六个属性完全一致:
🔷Tracker
- Breakfast::
- Feeling::
- Working On::
- Money Spent::
- Workout::
- Motivation::
也就是说:**日日志 V2 负责每天记录这六个维度,周日志 V2 的表格则把它们按天横向汇总**,形成从"日记录"到"周汇总"的闭合链路。README 中项目对模板的定位正是"a reference for any user to build on them or to take ideas"——这套字段体系就是可以复用的骨架。
### 5.2 表格结构:一行一天,手动填写
表格共 7 列:Day(星期几)+ 六个 emoji 维度列。模板内置了一行占位行(7 个空格单元格),实际使用时建议复制为周一至周日 7 行,例如:
| Day | 🍜 | ✨ | ✏️ | 💲 | 💪 | 📈 |
|---|---|---|---|---|---|---|
| Mon | ✅ | 3/5 | 笔记系统 | ¥42 | 30min | 4/5 |
| Tue | ✅ | 4/5 | 阅读 | ¥0 | 休息 | 4/5 |
| ... |
填写策略可以灵活:早餐/锻炼用勾选,感受/动力用 1–5 或表情,花销用具体金额,正在做的事用简短短语。README FAQ 提到作者假设用户安装了 **Advanced Tables** 插件来提升表格编辑体验;如果你只用核心插件,Obsidian 自带的 Markdown 表格编辑也已够用。
### 5.3 手动表格 vs V1 的 DataView 自动聚合
为什么要"手动填表"?对比 V1 周日志 <a href="https://link.gitcode.com/i/78bb9bd63b2d1a6b7c85f56bf0a7fc73" target="_blank">0A_1_6_WeeklyLog.md</a> 就能看出设计取舍:V1 使用 DataView 查询,自动把同一文件夹内带 `#Log/dailylog` 标签的日日志字段聚合进表格:
TABLE WITHOUT ID
link(file.name) as "Day",
Breakfast AS "🍜",
Feeling AS "✨",
working-on AS "✏️",
money-spent AS "💸",
Workout AS "💪",
Motivation AS "💹"
WHERE file.folder = this.file.folder AND
contains(tag, "#Log/dailylog")
SORT file.name ASC
自动聚合的代价是必须安装 DataView 社区插件。而 Weekly Log V2 选择把表格还原为纯 Markdown 手动填写,**把对插件的依赖降到最低(仅剩可选的 TOC 插件)**,更贴近仓库"只用核心插件、面向新用户"的定位。两者取舍:
| 对比项 | Weekly Log V1(<a href="https://link.gitcode.com/i/5b59d51e697059af453715316ec15296" target="_blank">0A_1_6</a>) | Weekly Log V2(<a href="https://link.gitcode.com/i/7bdb257f42bffd3a52cf969cea2eee7f" target="_blank">0A_1_9</a>) |
| --- | --- | --- |
| 表格来源 | DataView 自动聚合 | 手动填写 |
| 插件依赖 | DataView(社区插件) | 仅核心插件(TOC 可选) |
| 适用人群 | 已装 DataView 的进阶用户 | 新用户、追求零依赖 |
| 字段对应 | 依赖日日志属性命名一致 | 自由填写,无需约定 |
## 六、五大复盘板块:从"记录"走向"回顾"
表格之下是五个 H3 复盘板块(<a href="https://link.gitcode.com/i/88d60c9fc53c68ea8fae976fc99ae3a5" target="_blank">0A_1_9_WeeklyLog_V2.md</a>),它们把一周的事实记录升华为可执行的复盘:
- **📑 Got Done This Week(本周完成)**:列出本周实际完成的事项,对应"成果"视角。写法上延续模板的 `-` 空列表,可以改成 `- [x] 完成 xxx` 的任务列表样式。
- **🔃 Need to Work On(需要改进)**:记录未完成、做得不够或下周要补的部分,对应"差距"视角。
- **📜 Events(事件)**:记录本周值得标记的事件,如里程碑、突发状况。仓库中其他日志模板也采用同一板块——例如 <a href="https://link.gitcode.com/i/ce88cf4b6e34cead217586aab6a02aac" target="_blank">0A_1_2_WeeklyReview.md</a> 用"Biggest Career Milestone"进一步细化。
- **📃 Projects(项目)**:登记各项目在一周内的进展。V1 在此处扩展了四个自问(完成什么 / 对进展满意吗 / 遇到哪些挫折 / 未来如何改进,见 <a href="https://link.gitcode.com/i/3d210d0fc7184007bead47e2622f5f84" target="_blank">0A_1_6_WeeklyLog.md</a>),V2 则精简为一行列表,把追问留给你自己的复盘习惯。
- **💾 Information to retain(需要留存的信息)**:摘录一周里值得长期保留的知识点、想法或引用。这与月日志 <a href="https://link.gitcode.com/i/3b9aa5c279a9ce9b2483e22d83356eb6" target="_blank">0A_1_3_MonthlyLog.md</a> 中的"Information to retain from the daily logs"一脉相承——周日志负责承上启下:从日日志吸收信息,再沉淀给月/年复盘。
从模板演进看,V1 的板块是"Weekly Reviews / Reflection / Events / Projects / Information to retain",V2 改成了"Got Done / Need to Work On / Events / Projects / Information to retain":把模糊的"Review/Reflection"拆成"完成 vs 待改进"两个可操作的动作,反思导向更明确。
## 七、把模板接入你的 Vault
模板本身只是一份 Markdown 文件,接入方式很轻量(README 的 Usage 一节给出了两种官方推荐做法):
1. **整库方式**:下载 OB_Templates 仓库,解压后把 `0A_Templates` 文件夹(或只取 `0A_1_Logs/0A_1_9_WeeklyLog_V2.md` 单个文件)放进你的 Vault。
2. **单文件方式**:在仓库中打开目标模板文件,**切换到 raw(原始)模式**复制全文,粘贴到 Vault 中新建的笔记文件里。
接好后按 README FAQ 的提示完成两件事:
- **启用并配置 Obsidian 原生 Templates 核心插件**(设置 → 核心插件 → Templates),把模板文件夹指向存放位置,之后即可通过命令面板"Templates: Insert template"插入模板;
- 插入时 `{{date}}`、`{{time}}`、`{{date:ww}}` 占位符会自动替换为实际时间,无需手动改动。
如果你同时安装了仓库 FAQ 提到的 DataView 与 Advanced Tables,体验更顺;没有也不影响本模板使用。
## 八、周日志三版对比与选型建议
`0A_1_Logs` 目录下实际存在三份周日志相关模板,可以从 <a href="https://link.gitcode.com/i/90d9ff2cb0b6158631db592abb936058" target="_blank">0A_Index.md</a> 索引中定位,按需选用:
| 模板 | 定位 | 特点 |
| --- | --- | --- |
| <a href="https://link.gitcode.com/i/64e64a6074b772a11b27ebd720bfe2d9" target="_blank">0A_1_6_WeeklyLog.md</a> | 周日志 V1 | DataView 自动聚合日日志字段;复盘含 4 个项目自问 |
| <a href="https://link.gitcode.com/i/7d25167336227816299c9fbfcf209d62" target="_blank">0A_1_9_WeeklyLog_V2.md</a> | 周日志 V2 | 手动六维追踪表 + 精简复盘;仅核心插件 |
| <a href="https://link.gitcode.com/i/ed11061a9ce18e0d8f2bdb46ff2a4889" target="_blank">0A_1_10_WeekAndDailyLog.md</a> | 周 + 日合体 | 逐日细分三餐(Breakfast/Lunch/Dinner)、情绪(Motivation/Stress/Physical/Mental Energy)、日类型(Personal/Work) |
选型建议:
- **新用户 / 想彻底避免社区插件**:首选 Weekly Log V2,手动表格零学习成本,复盘板块即拿即用;
- **已在用 DataView、日日志属性规范**:Weekly Log V1 的自动聚合表能省去每周手动搬运数据;
- **想要更细粒度的周内记录**:WeekAndDailyLog 合体模板(<a href="https://link.gitcode.com/i/ed11061a9ce18e0d8f2bdb46ff2a4889" target="_blank">0A_1_10_WeekAndDailyLog.md</a>)在周框架内内置了每日三餐、四维情绪与日类型(Personal/Work/Work & Personal)的填写位,适合需要量化生活节奏的用户。
## 九、注意事项与 FAQ 要点
综合 README 的 FAQ 与模板实际情况,使用时有几点值得注意:
1. **标签拼写不统一**:V2 模板中标签为 `Log/WeeklLog`,与 V1 的 `Log/WeeklyLog` 不同,且 README 声明标签只是示例。建议个人使用时统一拼写,否则影响按标签聚合。
2. **索引与文件名的漂移**:<a href="https://link.gitcode.com/i/aab1bfb660c6be03f2c627b682594714" target="_blank">0A_Index.md</a> 中该条目写作 `0A_1_9__MonthlyLog_V2`(双下划线,描述为"月度复盘 V2"),而实际文件是 `0A_1_9_WeeklyLog_V2.md`(周日志 V2);同页把第 10 号文件写作 `0A_1_10_WeeklyLog_V2`,实际文件名为 `0A_1_10_WeekAndDailyLog.md`。**以实际文件名为准**,索引仅作参考。
3. **ISO 周数的边界语义**:`{{date:ww}}` 输出 ISO 周数,跨年时可能出现"1 月 1 日仍属于上一年第 52/53 周"的情况;用周数做标题时建议配合年份(如 `Week {{date:ww}}` 所在月份)一起确认。
4. **插件依赖边界**:模板本体只依赖核心功能;`toc` 块需 Dynamic Table of Contents 插件才渲染,DataView 与 Advanced Tables 为 README 声明的"假设已安装"项,缺省时模板依然可用,只是少了一些体验增强。
5. **模板是参考不是标准答案**:README 明确说明这些模板"not designed to be perfect, they are intended to be used as a reference"——字段、板块、emoji 均可按你的记录习惯增删改。
## 结语
Weekly Log V2 是一份把"日常记录 → 周汇总 → 复盘沉淀"串成闭环的轻量模板:六维追踪表让一周状态一目了然,五个复盘板块把事实变成下一步行动,而全程只依赖 Obsidian 核心功能。对照仓库内的 Daily Log V2、Weekly Log V1 与合体版 <a href="https://link.gitcode.com/i/ed11061a9ce18e0d8f2bdb46ff2a4889" target="_blank">0A_1_10_WeekAndDailyLog.md</a>,你可以按自己的插件预算与记录粒度,组合出一套完全属于个人的周复盘体系。