Obsidian 跨端笔记搭建：从安装到 iCloud 同步与模板化写作（macOS/iOS）

1. 为什么用 Obsidian：用一个“本地优先”的知识库替代碎片记录

Obsidian 的核心是把笔记保存为本地 Markdown 文件（一个文件夹就是一个“库”）。好处是：可迁移、可备份、可用任意编辑器打开；同时又能用它的链接、图谱、搜索和插件把零散信息串起来。它适合做项目资料库、读书笔记、工作 SOP、长期日志等。

2. 安装与准备：先选好库位置，后面同步才不会折腾

在 macOS 上安装后，首次创建 Vault（库）时建议先确定存放位置：例如放在 iCloud Drive、或放在本地再用其他同步方式。若你打算用 iCloud 同步到 iPhone/iPad，最省心的做法是把 Vault 直接建在 iCloud Drive 里，并保持文件结构简单（一个 Vault 一个文件夹）。

3. iCloud Drive 同步的正确姿势：让桌面和移动端指向同一个 Vault

在 macOS：把 Vault 文件夹放在 iCloud Drive（Finder 侧边栏“iCloud Drive”）中。然后在 Obsidian 里选择“打开文件夹作为库”，指向该文件夹。

在 iOS：Obsidian 选择“打开文件夹作为库”，在“文件”App 里选中同一个 iCloud Drive 下的 Vault 文件夹。首次同步可能需要一些时间，等文件数量稳定后再开始批量改名或移动。

注意：尽量避免同时在多设备上对同一篇笔记做大段编辑；如果你经常多端并行写作，建议养成“写作只在一个端完成、其他端只查阅/小改”的习惯，以降低冲突概率。

4. 文件与目录建议：3 层以内，越简单越稳

一个常用结构是：00-Inbox（收集箱）/ 10-Projects（项目）/ 20-Notes（沉淀）/ 90-Archive（归档）。新内容先丢进 Inbox，定期整理到 Projects 或 Notes。目录不必过度复杂，避免频繁移动导致链接断裂或同步变慢。

5. 模板化写作：把常用格式做成“新建即用”

启用 Templates 插件（设置 - 核心插件 - 模板），新建一个“Templates”文件夹，放入常用模板。例如会议记录模板：标题、日期、参会人、待办、结论；读书笔记模板：摘要、金句、观点、行动清单。这样每次新建笔记就能一键插入，减少空白页焦虑。

6. 三个上手就能提升效率的技巧：搜索、链接、与回顾

搜索：学会用关键词 + 过滤（如按路径/标签）快速定位材料；把常查的关键词做成固定搜索。

链接：用双向链接把“概念-案例-项目”串起来；遇到陌生名词先建一条占位笔记，后续逐步补全。

回顾：每周固定 10 分钟清空 Inbox，把散点信息归位；长期坚持比一次性大整理更有效。

7. 工具地址与参考链接

Obsidian 官网：https://obsidian.md/

iCloud Drive 官方说明：https://support.apple.com/zh-cn/HT204025

8. 常见问题：同步慢/丢文件怎么办

如果发现移动端文件还没出现，先确认 iCloud Drive 已开启、网络稳定，并给 iOS 端一点时间完成首次下载。避免一次性导入上万文件；大量图片或附件建议放到单独的附件目录，并定期清理无用素材。遇到冲突文件时优先保留最新版本，再手动合并内容。