为什么是 Obsidian

Vault 没有神秘结构

Obsidian vault 就是电脑上的一个文件夹，核心内容是 .md 文件。Finder、VS Code、终端和 Claude Code 都可以直接打开。Obsidian 提供双向链接、图谱、搜索与插件，但不把你的内容锁进专有数据库。

这意味着即使未来更换工具，Markdown 文件仍然可以保留、复制和编辑。

Markdown 是 AI 熟悉的表达

原书强调三个特性：

• Token 效率：相较更冗长的结构化格式，Markdown 用更少标记表达清楚层级。
• 结构清晰：标题、引用、列表和代码块天然形成语义边界。
• 读写一致：大模型既熟悉 Markdown 输入，也经常直接输出 Markdown。

本地文件进一步消除了 API 中间层。Claude Code 可以直接搜索、修改、移动和重命名文件，每一步都能被 Git 记录。

多个 Agent 项目的共同选择

原书用 Manus、OpenClaw 与 Claude Code 举例：它们分别用 task_plan.md、MEMORY.md、SOUL.md、CLAUDE.md 等 Markdown 文件保存计划、记忆或规则。这里的关键洞察不是某个产品的规模，而是独立团队都选择了可读、可移植、可版本控制的文本。

向量数据库在百万级语义检索中有价值；个人知识库通常更需要低延迟、零额外成本、直接编辑和可追溯修改。两者不是永远互斥，但不应在一开始就引入更重的系统。

Obsidian 多做的那一层

标准 Markdown 之上，Obsidian 增加了 [[双向链接]]、callout、frontmatter、Canvas 和 Bases 等语法或文件类型。它还提供快速跳转、全文搜索、关系图谱和插件生态。

这正好补上“裸文件夹 + AI”欠缺的浏览与关系界面，同时保留底层文件的开放性。

本课练习：做一次可逆性检查

• 在 Finder 中找到一个现有 Markdown 文件夹
• 分别用文本编辑器和 Obsidian 打开同一文件
• 新建一个 [[双向链接]]，再回到文本编辑器查看原文
• 写下你的数据是否能在没有原应用时继续读取

请检查当前目录是否适合作为 Obsidian vault。只输出报告：
1. Markdown 文件数量和主要目录；
2. 非 Markdown 文件的类型；
3. 可能影响跨工具使用的专有格式；
4. 在不移动原文件的前提下，给出最小迁移步骤。

判断工具时，先问“数据是不是你的普通文件”，再问“功能是不是足够多”。