夜雨聆风大家好，我是噪点
上篇分享了 karpathy 提的 ai 时代知识库管理新范式 llm wiki，我用AI复活了散落 10 年的笔记：Karpathy 方法实测，里面有简单提到笔记管理工具 obsidian。
今天就来专门聊聊这个工具，算是一篇完整的入门指南，0 基础朋友看完也可以直接上手。
说实话，如果是一年前，我倒并不推荐用 obsidian，因为当时 agent 能力还不成熟；如果纯靠人力去维护笔记，obsidian 相比飞书文档、印象笔记、备忘录这些，体感上还是太重了，门槛高，我也是用一段时间后放弃了。
但今年情况不一样了，codex、claude code、openclaw、hermes 这些 agent 一个比一个成熟能打，做知识库这件事的最优解被彻底改写了；obsidian 也一下子从"重工具"变成了 ai 时代非常合适的本地知识库底座。
聊它之前，先说下笔记这件事的真实痛点。
我自己十多年的笔记，散在飞书、印象笔记、备忘录、word 文档等一堆地方，因为各种奇奇怪怪的问题吧，基本上是用一阵换一个。笔记确实都记下来了，但每次想找对应具体内容都得反复切工具搜，找一篇旧笔记跟玩寻宝一样。
更要命的是，有些云端工具数据是被绑死的，想迁出来非常麻烦，甚至格式不通用，所以我一直想找一个能把所有笔记统一管起来、永远在自己手里的本地知识库工具。
obsidian 就是这个答案。
还是按老习惯，先从是什么讲起，再分享具体步骤；会从 obsidian 是什么、下载和上手、必备 skill、插件推荐 4 部分展开。
大白话说，obsidian 就是一个完全免费的本地 markdown 笔记软件。
里面所有笔记都是一个个 .md 纯文本文件，存在我们自己电脑的某个文件夹里。也就是说哪怕某天 obsidian 没了，也不影响文件夹，笔记一点儿也不会丢。
它有 4 个我特别喜欢的点。
完全本地：和一些在线笔记工具不一样，obsidian 不依赖任何云服务，断网也能用，数据完全是你自己的。
markdown 纯文本：所有笔记都是纯文本格式，agent、ai 工具、任何文本编辑器都能直接读写，这个是 ai 时代选择工具的关键。
双链：在一篇笔记里写[[某个笔记名]]就能跳过去，等于自动给你的笔记建了关系网，越用越能看出知识之间的连接脉络。
插件生态：基础功能其实很简单，但靠社区插件可以实现非常多的复杂功能和玩法。
这也就是为什么我说 ai 时代 obsidian 特别合适：因为本地 + 纯文本 + 文件夹这三个特性叠加，agent 就可以直接像翻文件夹一样读写我们的笔记。vault 就是它的工作目录，文件就是数据，没有比这更原生的配合方式了。
直接进官网选择版本下载即可：
打开后会让你先建一个 vault。
vault 大白话就是 obsidian 的"工作仓库"，本质就是你电脑上的一个普通文件夹，所有笔记、设置、插件都在这一个文件夹里。
这里有个建议：整个 obsidian 建一个 vault 就够了。
我看到有些朋友会按"工作"、"个人"、"创业"开好几个 vault，这倒反而不建议。
一个是插件和主题设置都跟着 vault 走的，开几个 vault 就要重复配几遍，更新一次插件要点几次，维护成本很高；
另一个更主要的是，obsidian 的灵魂是双链，但双链不能跨 vault，一旦分库，本来可以连起来的笔记就成了一个个孤岛，越分越散。
所以建议直接建一个 vault，再用子文件夹分类就行。
进入 vault 后，新建一篇笔记，输入[[ 就会自动出现已有笔记的下拉，选一个就完成了双链。点击双链可以直接跳过去。这是整个 obsidian 最核心的体验之一了。
vault 建好了，还需要再装一些使用 obsidian 的必备 skill，让 agent 知道怎么和你的 vault 工作。
obsidian 有个官方 skill 库，是 obsidian 创始人 kepano 自己维护的，可以放心用。
里面一共 5 个 skill，建议全部装上。
obsidian-cli：让 agent 通过终端命令行直接操作 vault，不需要打开 obsidian 软件就能读写笔记、搜索、建文件夹。
obsidian-bases：教 agent 写 .base 文件，类似 notion 的数据库视图，可以做表格、筛选、公式等。
json-canvas：教 agent 写 .canvas 无限画布文件，做思维导图、流程图、白板这类内容。
obsidian-markdown：教 agent 写 obsidian 风格的 markdown，包括双链、callout 等这些专属语法，让 agent 写出来的笔记和手写的格式一致。
defuddle：让 agent 从网页抓干净的 markdown 内容喂进 vault，比直接复制网页省 token。
这 5 个 skill 可以下方一行命令直接搞定：
npx skills add git@github.com:kepano/obsidian-skills.git装好后在 claude code 等 agent 里直接调用即可，agent 会自己根据任务挑合适的 skill。
obsidian 的插件市场可以说是它的灵魂之一，几千个插件，按需求装就行。
通用插件的安装路径很简单：设置 → 第三方插件 → 关闭安全模式 → 浏览社区插件市场 → 搜索想要的插件 → 安装 → 启用即可。
这里就不一一列举了，每个人需求不一样，大家自己去插件市场逛一圈按需装即可。
就只讲一个插件，claudian，这是 obsidian 比较火的一个 ai 插件，目前已经 10k+ stars。
它的核心定位是把 claude code、codex、opencode 这些 ai agent 直接嵌进 obsidian，vault 直接变成 agent 的工作目录。简单理解就是不用开终端、不用切窗口，你就能直接在 obsidian 侧边栏里使用claude code、codex等，这些agent可以读你的笔记、改你的笔记、跨文件搜索、跑命令。
几个我用下来觉得很爽的点。
侧边栏聊天：直接和 agent 对话，不用开终端，写笔记的时候随问随改。
inline edit：选中一段文字按快捷键，agent 可直接修改，还有 diff 预览，前后修改一目了然。
@mention：输入@可以引用 vault 里任何文件、subagent、mcp 服务等，给 agent 上下文非常方便。
可以直接将下面项目链接丢给常用的 agent，让 ai 帮忙安装，非常方便。
整套装下来，我最直观的感受就是：以前的笔记软件是给人看的，obsidian 是给人和 ai 一起看的。
我们之前花很多时间在写 claude.md 教 ai 怎么干活，但 ai 还需要一个能持续读、持续写的本地知识库，这样才能真正长期帮我们沉淀东西。
obsidian 在这件事上，目前是我个人觉得非常合适的方案。
本地、纯文本、文件夹结构、插件生态，都能匹配现在 ai 时代的要求。
如果还没用过 obsidian 的朋友，可以直接花十分钟装一下，先把 vault 建起来，再把 5 个 skill 装上，整个底座就建好了。
后面无论是搭 wiki、写文档、整理资料，都可以直接在这套底座基础上搭，真的会越用越方便。
如果觉得本篇分享对你有帮助，欢迎一键三连，方便更多朋友看到～
对AI工具、AI干货技巧、vibe coding感兴趣，可以给『噪点』加个星标 ⭐️，第一时间获取推送！也欢迎交个朋友～
