Obsidian 子弹笔记月度日志模板实战:用 BuJo Monthly Log 构建 Zettelkasten 月度规划面板
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取值一一对应。
联动逻辑如下:
- 年度层面:在 5_BuJo - Future Log 中规划"Objectives & Key Results | 3-4 & 1-4"与"Key Actions | 1+",用 OKR 模板创建
okr: objective、okr: keyresult的笔记并统一标注status: active_2026; - 月度层面:Monthly Log 的 OKR 查询把
status值改为当年值(如active_2026),即自动把年度目标拉入当月面板; - 追踪方式:
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 个必需插件:
- Bases —— 创建基于数据库的笔记视图,用于查看、编辑、排序、过滤文件与属性;
- Book Search —— 从 Google Books API 生成书目笔记(文献笔记类模板需要);
- DataView —— 提供查询语言,用于从 Markdown 页面过滤、排序、提取数据——Monthly Log 模板的两段核心查询(OKR、Kanban)依赖它,是本文所有 DataView 代码块运行的前提;
- Frontmatter Tag Suggest —— 在 YAML Frontmatter 中自动补全标签;
- Wikipedia —— 获取维基百科首段并粘贴到当前笔记。
(另有 9 个可选插件,如 Auto Link Title、Charts、Iconize、PlantUML 等,用于增强体验,非月度日志必需。)
落地步骤建议:
- 在 Obsidian 设置中启用核心插件"模板(Templates)"并指定模板文件夹路径;
- 把 5_BuJo - Monthly Log.md 复制进该文件夹(同时建议复制 Future/Weekly/Daily 三份,保持节奏完整);
- 安装并启用 DataView 插件;
- 每月 1 日插入模板,按第五节修改
status年份值,填写当月 OKR 与 Kanban 状态; - 参照 EXAMPLES.md 中展示的各类模板产出样例,校准自己的笔记格式。
八、月度复盘与模板适配技巧
月度日志的价值在月末复盘时兑现。建议的复盘闭环是:
- 看 OKR 区块:对照
template_type列区分目标与关键结果,逐个核对完成度;未完成的 KR 可以降级为下月status或移入 Backlog; - 看 Kanban 区块:把
doing中未完成的任务改写为backlog或todo,遵循 WIP Limit 3 的原则为下月挑选新任务; - 看 Calendar:回顾日期锚点下的流水,总结当月节奏;
- 维护 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 中也保留了对应版权注释,使用与再分发时请遵守该许可条款。