我把主力文档工具从 Notion 迁移到了 Obsid

我把主力文档工具从 Notion 迁移到了 Obsidian。

Obsidian 不仅有原生 Vim 支持和丰富的扩展，原生 Markdown 文件的形式实际上非常利于和 agent 协同工作，不需要 MCP，只需要在 obsidian vault 目录下启动 agent，它就能读到我的所有文档笔记。

不过既然要人机协作，git 版本管理是必不可少的。今天分享一下对 iCloud 同步的 Obsidian 仓库进行版本控制的正确姿势。

首先，不建议直接在 vault 目录下直接新建 git 仓库，而是外挂到本地，比如这样：

“`
git init –separate-git-dir=”$HOME/git-repos/obsidian-vault”
“`

这样初始化 git 仓库，产生的不是 .git 目录，而是一个 .git 文件，它指向你本地电脑的路径。

为什么外挂 Git？——一方面是节省 iCloud 存储空间，另一个更重要的原因是 Git 本身并不适合放在 iCloud 里面，因为同步功能对这种高频、细碎的文件写入并不友好，最好还是将版本管理与文件同步解耦。

另外，也建议 .gitignore 排除 .obsidian, attachments 目录，以避免图片和附件文件导致 git 膨胀，况且它们也不需要版本管理。

同时，在每个设备上对这个 iCloud 文件夹勾选 Keep downloaded，避免下次打开的时候，老是要重新下载。
#TIL #ClaudeCode #Obsidian