Obsidian 使用技巧

用了两年 Obsidian，从最开始的「这不就是个 Markdown 编辑器吗」，到现在它成了我每天打开时间最长的工具，中间的认知转变挺大的。Obsidian 真正值钱的地方不在编辑器本身，在它那套以「连接」为核心的笔记哲学，和几个一旦用上就回不去的工程化能力。

这篇不是 Obsidian 的功能罗列，是我自己实际用了两年、踩了无数坑之后，真正改变我工作流的几个技巧。每个都解决一个具体的痛点，不是「了解一下就好」的炫技。

双链，笔记从堆放变成网络

Obsidian 最核心的能力是双链，[笔记名](/blog/笔记名) 能把两篇笔记连起来，而且这种连接是双向的，A 链到 B，B 那边自动显示「被 A 引用了」。

这个功能听起来不起眼，但它改变了笔记的组织方式。传统笔记是树状的，文件夹套文件夹，一篇笔记只能待在一个地方。双链让笔记变成网状，一篇笔记可以从多个角度被引用，从任何一个相关入口都能找到它。

比如我写「分布式锁」的笔记，链到「Redis」「CAP 定理」「Zookeeper」这几篇。以后我打开「CAP 定理」，侧边栏会显示「分布式锁引用了这篇」，我就知道这两篇有关系。知识就这么自然地连成网，而不是散落在各个文件夹里互相找不到。

双链配合别名 [显示文字](/blog/target) 也很实用。链到「分布式锁」那篇笔记，但想在当前语境里显示「锁机制」，用 [锁机制](/blog/分布式锁) 就行。链接指向不变，显示更贴合上下文。

模板，把重复的结构沉淀下来

写技术笔记多了会发现，很多文章的结构是重复的。每篇都要有 frontmatter、都要有小节、都要有代码块示例。手动敲这些重复部分既慢又容易漏。

Obsidian 的模板功能解决这个问题。我定义了几种模板，技术文章的、会议记录的、读书笔记的，每种模板预置好结构和占位符。新建笔记时一键插入模板，骨架就有了，往里填内容就行。

模板最大的价值不是省敲键盘的时间，是把好的结构沉淀下来。我用模板强制自己每篇技术笔记都带上「背景」「核心问题」「方案」「代价」这几个部分，久而久之思考的完整性就上来了。模板是个隐性的思考脚手架。

变量让模板更灵活。{{title}}、{{date}} 这些占位符，插入模板时自动填成当前标题和日期。配合 Templater 插件还能写更复杂的逻辑，比如根据笔记所在目录自动套不同的模板。

自动同步，Obsidian Git 的正确打开方式

笔记本地放着不放心，得同步到远程备份。最早我手动 commit push，问题是经常忘，写了一堆笔记本地堆着没同步，换电脑就看不到。

后来配了 Obsidian Git 插件做自动同步。每 5 分钟自动 commit 加 push，后台静默执行，写完笔记不用管，过几分钟就在 GitHub 上了。换电脑 clone 仓库就能接着写，无缝。

自动同步有个隐患要意识。因为它是定时全量 commit，如果你在多设备同时编辑，可能产生冲突。解决思路是，尽量一次只在一台设备上编辑，或者冲突了手动解决。笔记这种低频编辑的场景，冲突概率不高，但要知道这个可能性。

Dataview，让笔记变成数据库

这是 Obsidian 里我觉得最被低估的插件。Dataview 能让你像查数据库一样查询笔记。

原理是这样。每篇笔记的 frontmatter 里可以加各种元数据（标签、日期、状态、优先级）。Dataview 提供一种查询语法，能跨笔记检索这些元数据，把结果聚合成表格或者列表。

比如我有一个「待办项目」的笔记，用 Dataview 查询所有 status: todo 的项目笔记，自动列成表格。新建一个项目笔记改了状态，那个表格自动更新。不用手动维护索引页，元数据驱动的自动聚合。

技术博客里我也用它。每篇文章的 frontmatter 有 tags 和 date，用 Dataview 能自动生成「按标签分类的文章列表」「最近更新的文章」这些索引页。文章增删不用手动改索引，Dataview 实时算。

全文搜索和命令面板

这两个是高频但容易被忽略的能力。

全文搜索（Ctrl+Shift+F）搜笔记内容，支持正则。笔记多了之后，靠文件夹找东西不现实，靠搜索。记住几条常用的搜索语法，能大幅提升找东西的效率。

命令面板（Ctrl+P）是 Obsidian 的中枢。所有操作都能从命令面板触发，不用记快捷键也不用翻菜单。熟练之后，手不离键盘完成所有操作，流畅度上来了。

工具之外，更重要的是习惯

讲了这么多技巧，最后说一句可能更重要的话。Obsidian 再强大，它只是个工具。真正让笔记有价值的是「坚持记」和「定期回顾」的习惯。

我见过太多人，折腾了一堆 Obsidian 配置和插件，笔记体系搭得漂亮，但实际不怎么记东西。工具用得再溜，没有内容产出也是空的。反过来，用一个简陋的文本编辑器但坚持每天记的人，笔记的价值远超那些工具党。

所以这些技巧的意义在于，它们能降低记录和整理的摩擦，让你更愿意记、更容易找。但前提是你有东西要记。把精力放在产出内容上，工具配置够用就行，别本末倒置。

这个博客本身就用 Obsidian 写。写完笔记把 publish 改成 true，Git 自动同步触发构建，几分钟就上线了。写作和发布之间零摩擦，这也是我能坚持写这么多篇的原因之一。工具帮我把「发文章」这件原本麻烦的事变简单了，我才能把精力放在内容本身。