用 iCloud 同步笔记

不需要注册账号，也不需要装插件。把文件夹放进 iCloud，用 SoloMD 打开它，就同步好了。

为什么不需要"配置同步"

SoloMD 的笔记就是硬盘上普通的 .md 文件，没有私有数据库、没有专有格式。 所以同步这件事根本不用 SoloMD 参与 —— iCloud 已经在同步那个文件夹了， SoloMD 只负责读写本地文件。

这也意味着：同样的办法对 Dropbox、OneDrive、Google Drive、Syncthing 一样有效， 下面的步骤把 iCloud 换成对应的云盘目录即可。

Mac 上怎么设置

1. 打开访达，点左侧边栏的 iCloud 云盘
2. 在里面新建一个文件夹，比如 Notes
3. 打开 SoloMD → 打开文件夹 → 选中刚才那个 Notes

结束了。之后每次保存，iCloud 会在后台把改动同步到你的其他设备。

这个目录在磁盘上的真实路径是 ~/Library/Mobile Documents/com~apple~CloudDocs/ —— 访达侧边栏里的「iCloud 云盘」指的就是它。知道这一点有时有用， 比如你想在终端里 cd 进去。

SoloMD 会为此多做两件事

1. 自动认出云盘文件夹

打开文件夹时，SoloMD 会检查它是不是在 iCloud / Dropbox / OneDrive / Google Drive 里。 认出来之后：

• 顶部会出现一条提示条，告诉你这个笔记库正在被云盘同步
• 不再提示你配置 GitHub 同步 —— 云盘已经在做这件事了，再劝你配一套只会是干扰

2. 跨设备接力：换台电脑接着上次继续

每台设备会在笔记库里写一个属于自己的小文件，记录你打开了哪些标签页。 换另一台设备打开同一个库时，如果发现别的设备有更新的记录， SoloMD 会问你要不要恢复到上次的状态 —— 标签页会照原样打开。

这些记录放在库里的 .solomd/ 目录，会跟着云盘一起同步。 它只在真正的云盘文件夹里生成：你打开一个普通的本地文件夹， SoloMD 不会往里放任何东西。

iPhone / iPad

一样的思路：iOS 版 SoloMD 通过系统的「文件」App 访问 iCloud 云盘， 打开你在 Mac 上建的那个 Notes 文件夹即可，两边是同一份文件。

安卓没有 iCloud（苹果没有提供安卓端）。 安卓要跨设备同步，可以用 Dropbox / OneDrive 之类有安卓客户端的云盘， 或者走 GitHub / Gitea 同步。

需要留意的地方

• 别在两台设备上同时编辑同一个文件。 iCloud 是文件级同步，它不会合并同一个文件里的不同改动 —— 真撞上了它会保留一个「冲突副本」，需要你自己手动合并。 日常在 A 电脑写、B 电脑看，是完全没问题的。
• 等它同步完再关电脑。 文件很大或网络慢时，iCloud 可能还没传完。 访达里文件名旁边有云朵图标就说明还在传。
• iCloud 没有版本历史。 想要"改错了能回退"、"能看到每次改了什么"、"冲突有提示和处理"， 那是另一条路 —— 见 同步、历史与备份， SoloMD 内置了本地快照和 GitHub / Gitea 同步，两者可以和云盘并用。
• 「优化 Mac 储存空间」可能把文件移到云端。 macOS 在磁盘紧张时会把不常用的文件只留在云上、本地只保留占位符。 笔记库通常很小，一般不会被挑中；如果遇到打开变慢， 可以在 系统设置 → Apple 账户 → iCloud 里关掉这个选项。

没生效怎么办

• 没看到云盘提示条？ 说明 SoloMD 没认出这个路径在 iCloud 里。最常见的原因是 你打开的是一个指向 iCloud 的替身/软链接，而不是真实路径。 直接从访达的「iCloud 云盘」进去重新打开一次即可。
• 另一台设备看不到新笔记？ 先确认两边打开的是同一个文件夹（不是各自本地的同名文件夹）， 再检查 iCloud 是否登录同一个 Apple 账户、以及「iCloud 云盘」开关是否打开。
• 还是不行的话，开个 issue 告诉我们你的路径和现象，我们跟进。