同步、历史与备份

你的笔记就是文件夹里的普通文件 —— 下面这些功能让这个文件夹既安全又随处可用。

Git 历史（本地快照）

• 设置 → 历史 → 初始化 Git 历史，把工作区变成一个本地 Git 仓库。不需要账号，什么都不会离开你的机器。
• 开启保存时自动提交后，每次保存都是一个快照。“立即保存快照”可随时手动提交。
• 历史面板按笔记显示时间线；一键对比或回滚到任意快照。

GitHub 同步 — 配置步骤

1. 创建 Personal Access Token（个人访问令牌，PAT）：位置在 github.com → Settings → Developer settings → Personal access tokens。两种都可以：
   • Fine-grained（推荐）：选择同步用的仓库（或 “All repositories”），在 Repository permissions 里把 Contents 设为 Read and write。注意你选择的过期时间。
   • Classic：勾选 repo 权限范围。
2. 回到 SoloMD：设置 → 同步 → 粘贴 token。SoloMD 会验证并显示你的 GitHub 用户名。
3. 关联仓库 —— 选一个已有仓库，或让 SoloMD 为你新建一个私有笔记仓库。
4. 通过工具栏胶囊按钮或命令面板推送 / 拉取；可选的自动推送 / 自动拉取在后台运行。

端到端加密（可选）

用一个口令开启 E2EE（端到端加密）后，SoloMD 推送的是加密影子副本而非明文 —— GitHub 上只存密文。口令永远不离开你的机器；没有口令，远端副本无法解密 （没有找回机制）。出于设计考虑，加密工作区的分享链接会被禁用。

分享链接

“复制本笔记的分享链接”会生成一个通过仓库渲染该笔记的 URL —— 想把单篇笔记发给别人、又不想开放仓库权限时很方便。

疑难排查

不用 GitHub 也能同步

因为笔记就是普通文件，任何文件夹同步工具都行：iCloud 云盘、 Dropbox、Syncthing、OneDrive —— 在每台设备上把 SoloMD 指向同步的文件夹即可。 Android 上通过系统文件选择器打开同一个文件夹；iOS 上使用「文件」App 中的位置。