Obsidian 子弹笔记月度日志模板实战:用 BuJo Monthly Log 构建 Zettelkasten 月度规划面板

原创2026-10-14 19:10:101,968 阅读
文章标签:知识库知识管理文档

Obsidian 子弹笔记月度日志模板实战:用 BuJo Monthly Log 构建 Zettelkasten 月度规划面板

本篇文章以开源仓库 Obsidian-Templates 中的 5_BuJo - Monthly Log 模板 为核心,系统讲解如何在 Obsidian 中落地一份"月度日志"结构笔记:从 YAML Frontmatter 属性契约、DataView 查询驱动的 OKR 与 Kanban 看板,到 31 天日历网格与 Back Matter 溯源结构。读完本文,你将掌握 BuJo(子弹笔记)与 Zettelkasten 相结合的月度规划模板的完整用法,能够直接复制、适配并扩展该模板,并用 DataView 查询语言把它与仓库中的 OKR、Kanban 工作流串联起来。

一、模板定位:BuJo 结构笔记在 Zettelkasten 中的角色

Obsidian-Templates 仓库的定位是"为 Obsidian 提供支持 Zettelkasten 笔记法的模板与脚本"(见 README.md)。在 Zettelkasten 体系中,除了闪念笔记(1_)、文献笔记(2_)、永久笔记(3_)、项目笔记(4_)之外,仓库还维护了一套编号为 5_ 的"结构笔记"(Structure Notes),用于承载工作流、索引与规划类内容。

BuJo(Bullet Journal,子弹笔记)正是这套结构笔记中的规划工具,仓库一共提供了四份配套模板:

模板文件 template_type template_version 职责
5_BuJo - Future Log BuJo Future "1.16" 年度愿景:OKR、关键行动、12 个月展望
5_BuJo - Monthly Log BuJo Monthly "1.20" 月度复盘:OKR 追踪、Kanban、31 天日历
5_BuJo - Weekly Log BuJo Weekly "1.18" 每周七日(Mon–Sun)行动清单
5_BuJo - Daily Log BuJo Daily "1.10" 每日 Ideas & Tasks 流水

从源码结构看,这套模板的节奏是"年度(Future Log)→ 月度(Monthly Log)→ 周度(Weekly Log)→ 日度(Daily Log)"层层下钻:Future Log 制定年度 OKR 与关键行动,Monthly Log 按月追踪 OKR 完成情况并维护当月的 Kanban 看板与日历,Weekly/Daily Log 则负责把目标拆解到可执行的天级任务。本文聚焦其中的"月度"这一环——template_version: "1.20" 的 BuJo Monthly 模板。

二、YAML Frontmatter:模板的数据契约

模板的开头是标准 YAML Frontmatter,这一段定义了整份月度日志的"数据契约",也是后续所有 DataView 查询的字段来源:

---
tags:
  - type/structure
  - structure/bujo
created: {{DATE:YYYY-MM-DD, HH:mm}}
modified: {{DATE:YYYY-MM-DD, HH:mm}}
template_type: BuJo Monthly
template_version: "1.20"
---

各属性含义如下:

  • tags:使用两级嵌套标签标识笔记类别。type/structure 表示这是一份结构笔记,structure/bujo 进一步标记为 BuJo 子类。这与仓库中 5_Structure Template 的 type/structure 约定一致,便于用 #structure/bujo 或 #type/structure 标签批量检索所有规划类笔记。
  • created / modified:使用 Obsidian 模板引擎的日期占位符 {{DATE:YYYY-MM-DD, HH:mm}},在套用模板时自动写入当前时间。格式为 YYYY-MM-DD, HH:mm,注意逗号后有一个空格。该字段会被 DataView 的 date() 函数正确解析,也可用 dateformat(file.mday, "yyyy-MM-dd") 做格式化展示(见下文)。
  • template_type:BuJo Monthly,唯一标识这份模板的用途。它是全仓库模板的"类型主键",Templates.md 中的总览清单正是用它来聚合模板的。
  • template_version:"1.20",模板的版本号。模板作者通过版本号追踪演进,读者在 Templates.md 的 DataView 清单中可以按版本列对比各模板的更新状态。

这一属性契约不是孤例:仓库中 5_OKR Template(v"1.23")、5_Structure Template(v"1.24")等全部采用 template_type + template_version 的双键约定,因此可以用一条 DataView 查询把仓库内所有 5_ 结构模板做成可维护的清单,例如 Templates.md 中:

TABLE WITHOUT ID
	file.link as "5_Structure",
	template_type AS "Type",
	template_version AS "Version",
	dateformat(file.mday, "yyyy-MM-dd") AS Modified
FROM "Templates"
WHERE contains(file.name,"5_")
SORT file.name ASC

三、正文结构逐段拆解

套用模板后,笔记正文自上而下由六个区块构成,每块解决一个具体的月度规划问题。

3.1 标题与导航链接

# {{Title}}

<!-- Main STRUCTURE of my content -->
Monthly Logs 2025 | [[2025]]
___

{{Title}} 由模板引擎在插入时替换为笔记标题(建议形如"2025-06 Monthly Log")。下一行是"面包屑导航":Monthly Logs 2025 是月份索引笔记的链接(%20 为文件名的空格转义),[[2025]] 是年度索引笔记的 wiki 链接。这两个目标都位于用户自己的 Vault 中,由使用者按年度创建——其作用是让每一份月度日志都能一键跳回年度索引与年度汇总,保持 Zettelkasten 的网状连接。___ 是横向分隔线,把导航区与正文区隔开。

3.2 OKRs 区块:月度目标追踪

TABLE WITHOUT ID
	file.link as "<small>OKRs</small>",
	template_type as "<small>Element</small>"
WHERE status = "active_2025"
SORT file.name DESC

这是模板中第一段 DataView 查询,它的语义是:

  • TABLE WITHOUT ID:输出表格时不显示文件名首列,改用 file.link 自定义列;
  • file.link as "OKRs":把笔记标题渲染为指向该笔记的可点击链接,列头文字同时把 OKRs 2023 索引笔记链接嵌入;
  • template_type as "Element":显示每条记录的模板类型列,帮助你区分列出来的是"Objective(目标)"还是"Key Result(关键结果)";
  • WHERE status = "active_2025":只列出 Vault 中 status 属性等于 active_2025 的笔记——这正是 5_OKR 模板中 status: active_2026 字段的联动点(详见第五节);
  • SORT file.name DESC:按文件名倒序排列,让最新的目标排在最上。

模板注释 *) Objectives (3-4) & Key Results (1-4) 给出了使用建议:每月的目标(Objective)控制在 3–4 个,每个目标下的关键结果(Key Result)控制在 1–4 条,与 5_BuJo - Future Log 中"Objectives & Key Results | 3-4 & 1-4"的约定完全一致。如果你没有使用 OKR 模板,把 status = "active_2025" 改成自己笔记的属性即可,例如 WHERE status = "open"。

3.3 Kanban 区块:进行中的任务看板

TABLE WITHOUT ID
	file.link AS "<small>3_Doing - Kanban</small>",
	length(file.tasks) AS "<small>Tasks"
WHERE kanban = "doing"
SORT file.ctime ASCENDING

这段查询负责把当前"正在做"的任务汇聚成看板的一列:

  • WHERE kanban = "doing":筛选 kanban 属性值为 doing 的笔记。这个属性约定来自仓库的看板体系——5_Structure Notes/Dataview - Kanban Board.md 展示了完整的四级状态机:#status/1_backlog(待办积压)→ #status/2_todo(待办)→ #status/3_doing(进行中)→ #status/4_done(完成),并标注 WIP Limit: 3(同时进行中的任务不超过 3 条,防止多任务切换损耗)。模板中的 kanban = "doing" 正是"进行中"这一列的属性化表达。
  • length(file.tasks) AS "Tasks":用 DataView 的函数 length() 统计每篇笔记内勾选清单(- [ ] 任务)的数量,让你一眼看出每项进行中工作的工作量。
  • SORT file.ctime ASCENDING:按文件创建时间正序排列,最老的排最上,体现"先来先做"的看板拉式原则。

配合使用方式:日常在项目笔记的 Frontmatter 中写 kanban: doing(或使用 #status/3_doing 标签),月度日志打开后即自动列出当月所有进行中的工作。

3.4 Tasks 区块

### Tasks 是纯手工维护的区块,模板中未内置 DataView 查询。建议的用法有两种:其一,直接以 Markdown 任务语法记录本月清单:

### Tasks
- [ ] 完成 6 月 OKR 复盘
- [ ] 归档 5 月的文献笔记

其二,若希望自动化,可自行加入一段汇总查询,例如 WHERE contains(file.tasks, "[ ]") 的 DataView 查询来统计未完成任务。模板保留该空白区块的设计意图,是让你按需决定"手工维护"还是"查询驱动"。

3.5 Calendar:31 天日历网格

### Calendar
.01
.02
.03
...
.31

模板以 31 行预置了从 .01 到 .31 的日期占位符,覆盖最长月份。这一设计的实操含义是:

  • 快速日志锚点:在当天日期行下追加内容,即可形成按日组织的事件与任务流水,例如 .15 下行写 - 完成月度 OKR 中期检查;
  • 与周度/日度日志衔接:.01–.31 的编号可作为跳转到对应 5_BuJo - Weekly Log 与 5_BuJo - Daily Log 的引用锚点;
  • 月末清理:遇到 30 天月份时删除多余的 .31 即可,保持模板的整洁。

3.6 Back Matter:五段溯源结构

月度日志的结尾复用仓库统一的"Back Matter(后记)"结构,与 5_Structure Template 完全同构:

# Back Matter

**_Sources_**
<!-- always keep a link to the [[source]] -->
- based_on::

**_References_**
<!-- see: [[permanent note]] because <reason> -->
- see::

**_Context_**
<!-- the scene at capture — see Subjective Context Principle. Optional but preferred. -->
- scene::

**_Terms_**
<!-- optional link to [[literature note]] with term & definition. -->
- term::

**_Targets_**
<!-- optional link to [[project note]] or published content. -->
- used_in::

各段职责(依据模板注释与仓库约定):

  • Sources(基于):based_on:: 记录本月日志内容的思想来源,格式为 based_on:: [[某条文献笔记]],保证任何结论都能回溯到源头;
  • References(参见):see:: 放置正文中未引用但相关的链接,并写明原因,如 see:: [[永久笔记]] because <reason>;
  • Context(场景):scene:: 记录创建时的上下文场景——模板注释称其为"Subjective Context Principle(主观上下文原则)",是可选但推荐填写的字段;
  • Terms(术语):term:: 链接到定义该术语的文献笔记,用于术语消歧;
  • Targets(去向):used_in:: 链接到项目笔记或对外发布的内容,回答"这份月度日志被谁使用/产出到哪里"。

这套"来源—引用—场景—术语—去向"的后记结构是仓库所有模板的通用尾注,作用是让每份结构笔记都融入 Zettelkasten 的链接网络,而不是孤立文档。

四、DataView 查询语法详解:把模板改造为自己的

Monthly Log 模板是 DataView 查询的典型样本。仓库在 x5_Table Snippet 中给出了更完整的语法参考(该片段注释中标明了模板版本 "0.1",供 5_Structure Notes 使用),可帮助你把月度面板扩展成任意形态。核心语法要素如下:

语法 作用 模板中的用法
TABLE WITHOUT ID 输出表格、不显示文件名默认列 OKR、Kanban 两段查询
file.link 将文件名渲染为可点击链接 表格首列
file.tasks / length(file.tasks) 访问笔记任务清单 / 统计任务数 Kanban 列的任务计数
file.ctime / file.cday / file.mday 文件创建时间 / 创建日期 / 修改日期 SORT file.ctime ASCENDING
FROM "文件夹名" 限定查询来源为文件夹 仓库中用 FROM "Templates" 列模板
FROM #tag/xxx 限定查询来源为标签 如 FROM #status/3_doing
WHERE 属性 = 值 按 Frontmatter 属性过滤 WHERE status = "active_2025"、WHERE kanban = "doing"
WHERE contains(file.name,"关键词") 文件名包含匹配 Templates.md 按 5_ 前缀分组
SORT 字段 ASC / DESC 排序 OKR 按 file.name DESC、Kanban 按 file.ctime ASCENDING
LIMIT n 限制返回条数 看板"Done"列可加 LIMIT 5 防膨胀
GROUP BY 属性 分组聚合 可对 OKR 列表按 author 分组

值得注意的补充选项(来自 x5_Table Snippet 的注释区块):

  • 来源选择三件套:FROM #target/forumzettelkasten(标签)、FROM "Books"(文件夹)、FROM ""(全库);
  • 布尔组合:FROM #status/open OR #status/wip;
  • 空值过滤:WHERE sketchnote != empty;
  • 日期格式化:dateformat(file.cday, "yyyy-MM-dd") 输出标准日期,dateformat(file.cday, "yyyy-LLL-dd") 输出月份缩写形式(该片段还标注了一个已知坑:dateformat(date(created, "yyyy-mm-dd, HH:MM"), "yyyy-mm-dd") 在 DataView 中存在解析 bug,建议谨慎使用)。

这意味着月度日志的 OKR 区块可以自由扩展为:按 status 组合过滤、按主题标签分组、限制条数等,而无需改动模板主体。

五、与 OKR 模板联动:从年度规划到月度追踪

Monthly Log 中 WHERE status = "active_2025" 的过滤条件,与仓库中的 5_OKR Template 是成对设计的联动机制。OKR 模板的 Frontmatter 如下:

tags:
  - type/structure
  - theme/objectives
  - type/okr
lead: +++ Lead paragraph goes here +++
okr: keyaction
status: active_2026
visual: "![[image.jpg]]"
created: {{DATE:YYYY-MM-DD, HH:mm}}
modified: {{DATE:YYYY-MM-DD, HH:mm}}
template_type: OKR
template_version: "1.23"

模板内的注释(5_OKR Template)给出了两个关键枚举:

  • okr:idea, wish, keyaction, keyresult, objective | annual——即一条 OKR 笔记可以是"想法、愿望、关键行动、关键结果、目标"中的任意一种,annual 表示年度级条目;
  • template_type:OKR, Wish, Objective, Key Result, Key Action——与 okr 取值一一对应。

联动逻辑如下:

  1. 年度层面:在 5_BuJo - Future Log 中规划"Objectives & Key Results | 3-4 & 1-4"与"Key Actions | 1+",用 OKR 模板创建 okr: objective、okr: keyresult 的笔记并统一标注 status: active_2026;
  2. 月度层面:Monthly Log 的 OKR 查询把 status 值改为当年值(如 active_2026),即自动把年度目标拉入当月面板;
  3. 追踪方式:template_type as "Element" 列让"目标 / 关键结果 / 关键行动"一目了然;当月推进某个 KR 时,直接在 OKR 笔记正文中勾选任务,月度日志无需任何改动即可反映进度。

关键技巧:修改年份只需批量替换 status 的值。例如把 active_2025 换成 active_2026 时,同时更新 5_OKR Template 的默认 status: active_2026,即可让新旧年度互不干扰地并行追踪。

六、与 Kanban 工作流联动:把月度计划变成周度行动

Monthly Log 的 Kanban 区块与仓库的看板体系 5_Structure Notes/Dataview - Kanban Board.md 共用同一套状态约定。看板笔记用标签实现四列:

  • FROM #status/1_backlog —— 积压待办(Backlog)
  • FROM #status/2_todo —— 待办(ToDo)
  • FROM #status/3_doing —— 进行中(Doing,WIP Limit: 3)
  • FROM #status/4_done —— 已完成(Done,示例查询加了 LIMIT 5)

Monthly Log 中的 WHERE kanban = "doing" 与看板中的 #status/3_doing 是同一状态的两套写法(属性 vs 标签),可以任选其一:

  • 偏好属性:在笔记 Frontmatter 写 kanban: doing / kanban: backlog,月度日志直接命中;
  • 偏好标签:写 #status/3_doing,看板笔记命中。

落到工作流上:月度日志的 Kanban 区块负责"这个月正在推进什么",5_BuJo - Weekly Log 的 Mon–Son 七日区块负责"本周推进哪些",5_BuJo - Daily Log 的 Ideas & Tasks 负责"今天做什么"——三级看板由同一状态字段驱动,形成"月度规划 → 周度拆解 → 日度执行"的闭环。

七、安装与使用:5 个必需插件与模板落地

根据 README.md 的说明,使用本仓库模板的安装方式为:将模板文件复制到你的 Obsidian 模板文件夹,即可在 Obsidian 的"插入模板"功能中调用。README 同时列出了运行本仓库模板所依赖的插件环境:

5 个必需插件:

  1. Bases —— 创建基于数据库的笔记视图,用于查看、编辑、排序、过滤文件与属性;
  2. Book Search —— 从 Google Books API 生成书目笔记(文献笔记类模板需要);
  3. DataView —— 提供查询语言,用于从 Markdown 页面过滤、排序、提取数据——Monthly Log 模板的两段核心查询(OKR、Kanban)依赖它,是本文所有 DataView 代码块运行的前提;
  4. Frontmatter Tag Suggest —— 在 YAML Frontmatter 中自动补全标签;
  5. Wikipedia —— 获取维基百科首段并粘贴到当前笔记。

(另有 9 个可选插件,如 Auto Link Title、Charts、Iconize、PlantUML 等,用于增强体验,非月度日志必需。)

落地步骤建议:

  1. 在 Obsidian 设置中启用核心插件"模板(Templates)"并指定模板文件夹路径;
  2. 把 5_BuJo - Monthly Log.md 复制进该文件夹(同时建议复制 Future/Weekly/Daily 三份,保持节奏完整);
  3. 安装并启用 DataView 插件;
  4. 每月 1 日插入模板,按第五节修改 status 年份值,填写当月 OKR 与 Kanban 状态;
  5. 参照 EXAMPLES.md 中展示的各类模板产出样例,校准自己的笔记格式。

八、月度复盘与模板适配技巧

月度日志的价值在月末复盘时兑现。建议的复盘闭环是:

  1. 看 OKR 区块:对照 template_type 列区分目标与关键结果,逐个核对完成度;未完成的 KR 可以降级为下月 status 或移入 Backlog;
  2. 看 Kanban 区块:把 doing 中未完成的任务改写为 backlog 或 todo,遵循 WIP Limit 3 的原则为下月挑选新任务;
  3. 看 Calendar:回顾日期锚点下的流水,总结当月节奏;
  4. 维护 Back Matter:补全 based_on(本月决策依据)、see(相关永久笔记)、used_in(产出物链接),让月度日志成为 Zettelkasten 网络中的正式节点。

适配技巧汇总:

  • 年份切换:批量替换 OKR 查询中的 active_2025,同时更新 5_OKR Template 默认 status 值;
  • 状态值对齐:若看板使用标签体系,把 WHERE kanban = "doing" 改为 FROM #status/3_doing,效果等价;
  • 列定制:参照 x5_Table Snippet 的选项清单,可加入 file.folder(来源文件夹)、file.etags(标签数)、length(file.outlinks)(出链数)等列;
  • 版本追踪:每次修改模板后递增 template_version,配合 Templates.md 的总览清单,可长期审计各模板的演进状态。

参考文件

  • 5_BuJo - Monthly Log 模板(本文主体,template_version "1.20")
  • 5_BuJo - Future Log 模板、5_BuJo - Weekly Log 模板、5_BuJo - Daily Log 模板
  • 5_OKR Template(okr/status/template_type 枚举来源)
  • 5_Structure Notes/Dataview - Kanban Board.md(Kanban 状态机与 WIP Limit)
  • Templates/x5_Table Snippet.md(DataView 查询语法参考)
  • Templates/Templates.md(template_type/template_version 的聚合查询示例)
  • README.md(安装方式与插件清单)
  • EXAMPLES.md(模板产出样例)

许可说明:本仓库模板遵循 CC BY-NC-SA 4.0(© 2022–2026 Edmund Gröpl),模板正文末尾的 Back Matter 中也保留了对应版权注释,使用与再分发时请遵守该许可条款。

登录后查看全文
Obsidian-Templates