类型	长什么样	什么时候用
`note`	蓝，信息	补充说明
`tip`	绿，灯泡	小技巧
`warning`	黄，感叹	注意
`danger`	红，闪电	危险操作
`example`	紫，列表	举例
`quote`	灰，引号	引用原话
`question`	橙，问号	待解决的问题
`bug`	红，虫子	已知问题

warning 和 danger 是这两个最实用的。 写教程的时候，"这一步会清空数据"用 danger，读者一眼就知道要停一下。

折叠：默认收起

在类型后面加一个减号，这个块默认是收起来的，点一下才展开：

加号 + 则是默认展开、可以手动收起。

长文里折叠特别值钱。 一篇教程里塞了十几条坑，全文铺开会把人吓走；收起来，读者想看的自己点开。

一个容易忘的细节

Callout 里面的每一行，前面都要带 >。少一个，那一行就掉出块外面了。

三、搜索进阶：按属性搜、按路径搜

上一篇讲了 Cmd+Shift+F 全局搜索。这一篇讲三个更精确的搜法。

按位置搜：file 和 path

file: 和 content: 的区别，就是搜标题还是搜正文。

按属性搜：frontmatter 变现的地方

上一篇定了 frontmatter 五个字段。这一篇告诉你它们能用来干什么。

Obsidian 较新版本支持按属性搜索，写法是方括号：

这就是规范 frontmatter 的真正回报。 字段填得规范，库就变成了一个能按条件筛的小数据库。

搜"还没整理的"最有用：

出来一堆闪念笔记，扫一眼就知道该处理哪些。

组合起来

意思是：在个人知识文件夹里，找出打了 AI 标签、正文提到 RAG 的笔记。 条件叠得越多，结果越准。

把搜索存下来

在笔记里写一个 query 代码块，这段搜索结果会实时显示在这篇笔记里：

它是一张活的清单。 处理完一条，它自己就从列表里消失，不用手动维护。

四、Templater：让模板动起来

上一篇讲了核心的「模板」插件。它有个短板：只能插固定文字，不能算日期、不能取文件名。

Templater 补的就是这个。上一篇把它列在"想清楚再装"里，现在可以装了。

装和设

社区插件里搜 Templater，装上、启用。

设置里指定一个模板文件夹，比如 98 模板。之后插入模板的姿势和自带模板一样。

三个最常用的变量

tp.date.now() 是核心。 日记模板里写死 created: 2026-10-03，第二天用还是这个日期；写成变量，用哪天就是哪天。

一个日记模板的骨架：

新笔记一建出来，日期、标题全填好了，光标停在待办那一行。 比手打快，也不会漏字段。

和自带模板怎么分工

ㅤ	自带模板	Templater
插入固定文字	能	能
算日期	不能	能
取文件名	不能	能
跑脚本	不能	能

只用固定模板的话，自带的够。 一旦发现"每次都手动改日期"，就换 Templater。

再来一个例子：读书笔记

日记模板只用到日期。更日常的场景是"每本书一篇笔记"：

新建笔记时把书名当文件名，title 就自动填上了，不用再手打一遍。

规律是：变量填的地方，都是"每次不一样、又必须填"的那几个。 日期、标题、文件名，全都是这一类。

常用变量

三个之外，这几个也常用：

tp.date.now() 的第二个参数是天数偏移，填 7 就是一周后。

tp.system.prompt() 适合"每次都要换个名字"的字段，比如项目名、客户名。插入模板的那一刻弹一个小框，填完就进正文。

让它自己套模板

手动插模板，还是会忘。Templater 里有个文件夹模板：约定"某个文件夹下的新笔记，自动用某个模板"。

比如把 100 日记/ 绑到日记模板，把读书笔记那个文件夹绑到读书模板。

配好之后，在对应文件夹里新建笔记，模板自己就上去了。 这是 Templater 比自带模板强得最明显的一处。

想再强一点：写一行 JS

<% %> 是输出结果，<%* %> 是执行一段 JS 但不输出。

多了一个 *，就能干"改文件名""挪文件夹"这类动作：

这一层新手用不上，知道有这么个口子就够。等哪天发现"这个动作每天重复三遍"，再回来查。

五、Dataview：把库当数据库查

上一篇把 Dataview 列在"想清楚再装"里。它是 Obsidian 里最能改变用法的一个插件，但也最容易装完不会用。

Dataview 用一段查询，把散在各篇笔记里的属性，汇总成一张动态的表。

前提：frontmatter 得规范

Dataview 只认 frontmatter。 字段名写错一个字母，它就查不出来。

所以顺序是：先把上一篇那五个字段用起来，攒上一两百篇，再来装 Dataview。顺序反了，会觉得它没用。

三种查询：LIST、TABLE、TASK

LIST：列出一组笔记的链接

TABLE：把属性做成表格

TASK：把所有待办汇总出来

TASK 这个最实用。 日记里随手写的 - [ ]，散在几十篇里，这一条查询把它们全捞出来，汇成一张总待办。

语法就四块

会这四块，日常够用了。 剩下的嵌套、分组、计算，用到再查。

它和 Bases 的关系

Obsidian 后来出了原生的数据库功能（.base 文件），想法和 Dataview 类似，但不用装插件。

两者取舍： 想少装插件、跟官方走，可以试原生那个；想要更细的查询语法，用 Dataview。具体在你客户端里是哪个版本、长什么样，以你界面为准——这类新功能更新快，我不替你打包票。

六、Canvas：一块白板理清关系

Canvas 是一张无限大的白板，上面可以放笔记卡片，再用线连起来。

左上角新建时选 Canvas，就得到一块空白画布。

三种放法

双击空白 → 新建一张卡片

从左侧文件树拖一篇笔记进来 → 变成一张引用卡，编辑原笔记它跟着变

拖图片、拖 PDF 进来 → 也能放

两张卡片之间拖一条线连起来，还能在线上写个字说明关系。

三个真正好用的场景

一、主题地图。 一个主题下所有相关笔记，摊在一张画布上，谁和谁近、哪块是空白，一眼看清。这比图谱好用——图谱是自动生成的，画布是你亲手摆的，带判断。

二、项目规划。 左边放"要做的"，右边放"做完的"，用线标出依赖。比纯列表多一个空间维度。

三、梳理一篇文章的论证。 论点放中间，论据围一圈，连上"支持"或"反驳"。

两个要知道的

画布文件是 .canvas，内容是 JSON。 里面存的是笔记的路径引用，不是笔记本身。所以别随便改笔记的文件名，改了画布上的卡片会断开。

别用画布当仓库。 它适合理关系，不适合存内容。内容还是放笔记里，画布只放链接。

七、MOC：比入口笔记更进一步

上一篇的入口笔记是"把这一层列出来"。MOC 是它的升级版。

MOC 全称 Map of Content，内容地图。围绕一个主题，把相关笔记按逻辑排成一页。

和入口笔记差在哪

ㅤ	入口笔记	MOC
按什么排	文件夹层级	内容逻辑
谁生成的	可以让 AI 批量生成	得自己想
会不会变	结构稳定	随理解加深一直在改

入口笔记是目录，MOC 是文章。 目录告诉你有哪些东西，MOC 告诉你这些东西之间是什么关系。

一个 MOC 长什么样

最后那一块"还没想明白的"是关键。 它把"我卡在哪"也记下来了，下次接着想。

什么时候该建 MOC

一个主题攒到七八篇笔记的时候。 少于这个数，直接看标签就够了；多了，才需要一个地方把逻辑理出来。

MOC 不用一次写完。 先列条目，读到新的往里加，理解变了就调整顺序。它是一份一直在长的东西。

八、批量维护：Linter 和批量改属性

库用久了，会出现一堆不一致：有的笔记 frontmatter 少字段，有的标题前后空行不一样，有的标签写成 #AI 有的写成 #ai。

手工改几十上百篇不现实。这一节讲两个批量处理的办法。

Linter：一键统一格式

社区插件搜 Linter，装上。

它能做的事：统一 frontmatter 字段顺序、补上缺失的字段、统一标题层级、删掉多余空行、统一列表符号。

配置好规则，可以设置成"保存时自动整理"。 之后每篇笔记一存，格式自动对齐。

注意：第一次全库跑之前先 commit。 Linter 会动很多文件，改坏了要有退路。

批量改属性：交给 AI

格式之外的事——改内容、改分类、统一叫法——交给 AI：

三个细节：

先说"先给我看"，别让它直接动手。看一眼清单，确认没问题再让它执行。

一次只做一类改动。 同时改标签、补字段、改分类，出了问题分不清是哪一步。

先 commit，再跑。 这条和上一篇讲 Git 时是同一个道理。

九、同步的进阶：三种方案怎么选、冲突怎么办

上一篇提了三种同步方式。这一篇讲怎么选，和出了冲突怎么办。

三种方案对比

ㅤ	官方 Sync	Git	第三方同步（Syncthing 等）
费用	付费	免费	免费
版本历史	有	完整	看方案
上手难度	最低	要会命令行	中
适合谁	不想折腾的	想要历史的	想省钱又能折腾的

最省心的是官方 Sync，最省钱的是 Git。 两个都想省钱又省心，往往最后两个都没配好——先选一个跑起来。

冲突是怎么产生的

两台设备同时改了同一篇笔记，同步工具不知道该听谁的，就会生成一个副本：

根本原因是"两边都改"。 所以最省事的规矩是——同一时间只在一台设备上编辑。手机上只记不整理，就是这个道理。

出了冲突怎么办

别急着删副本。两个文件都打开，对比一遍，把要的内容并到主文件里，再删副本。

如果用了 Git，git diff 能直接看出两个版本差在哪，比人眼比快得多。

一条经验

同步目录别放在会实时双向同步的网盘里，这条上一篇的坑 1 讲过。真要放，用手动单向上传，不要双向。

Git 同步：怎么配

思路很简单：整库放进一个私有仓库，每台设备各克隆一份。配之前先定两件事。

一、.gitignore 先忽略工作区文件。 .obsidian/workspace.json 记的是"当前开着哪几个标签页"，开开关关就变，同步它只会攒一堆没意义的提交。

二、.obsidian/ 的其余部分，看需求。 这里面存的是插件列表、主题、快捷键。想让几台设备长得一模一样，就同步它；想各配各的，就一起忽略。

手机端怎么办

移动端跑不了命令行，Git 得靠第三方插件，出问题不好修。

能用电脑同步就用电脑。手机只当"查看 + 随手记"的终端——这跟前面"同一时间只在一台设备编辑"是一个思路。

接着上一条说：网盘同步的两个麻烦

iCloud、坚果云、Dropbox 直接指到库文件夹，是最省事的。两个麻烦绕不开：

一、.obsidian/ 被一起同步，两台设备的插件设置互相打架。 结果是每换一台设备，侧边栏和插件都变样。

二、文件一多，网盘会卡。 几千个小文件，增量同步经常转圈。

能排除 .obsidian/ 就排除；不能排除，就别指望它在几千篇的库上还顺畅。 判断标准只有一条：同步完，两台设备打开是同一个样子。

最后补一句：同步不等于备份

同步做的事，是把改动在设备之间传开——两边一起删，就是真的没了。

重要的库另外留一份离线快照：导出个压缩包，或者定期推到 Git 远端。同步管的是"多设备一致"，备份管的是"出事能回来"，是两件事。

十、把库变成网站

库是纯文本，所以它能直接变成一个网站。这一节讲两条路。

付费的：Obsidian Publish

官方出的发布服务，选几篇笔记，点一下就上线，还带搜索和关系图。

好处是零配置，把哪些笔记公开，勾一下就行。代价是付费，而且样式定制空间有限。

免费的：Quartz

Quartz 是一个开源项目，能把 Obsidian 库编译成一个静态网站。生成的站点可以直接放 GitHub Pages。

流程大致是：

它认 Obsidian 的语法，双链、Callout 都能正常渲染，双链点进去能跳转到对应页面。

免费的代价是要会一点命令行。 但配好之后，npx quartz sync 一条命令就更新。

发之前一定要想清楚的一件事

哪些笔记能公开。

库里往往混着日记、工作记录、还没定稿的想法。发布前必须过一遍：

日记要不要发？多半不要

99 归档/ 要不要发？多半不要

带别人名字、带客户信息的，一定要排除

做法： 发布工具的配置里写死"只发布哪些文件夹"，比"排除哪些文件夹"安全——默认不发，主动挑着发。

十一、大库维护：几千篇之后

库小的时候什么问题都没有。过了几千篇，会开始出现几个症状。

三个常见症状

一、图谱变成一团毛线。 节点太多，连线糊成一片，看不出东西。

二、出现一堆孤儿笔记。 没有任何链接指向它们，也从不被搜到。

三、同一个概念散在多篇里。 三篇笔记都在讲同一件事，互相不知道。

定期做一次体检

每隔一两个月，让 AI 扫一遍：

先让它报告，不动手。 看完报告，再决定哪些要合并、哪些要补链接、哪些直接归档。

归档，不要删

不用的笔记，移到 99 归档/，别删。

理由： 双链还在。删掉一篇，所有指向它的链接变成断链；归档，链接还通，只是内容不在主流里了。

性能上的三个开关

库变卡，八成是这三样：

症状	原因	处理
打开慢、搜索慢	附件太多太大	清 `04 附件/`，PDF、音频挪出库外
启动慢	插件太多	关掉三个月没打开的
图谱卡	节点过万	图谱本来就不常看，用到再开