设置项备份与恢复——v2.7 新增，迁移设备或重置前必做
什么时候需要备份设置
Markor 的设置项包括：
- Notebook 根目录路径
- QuickNote 文件路径
- ToDo 文件路径
- LinkBox 文件路径
- 主密码（只有哈希，不是明文）
- 主题选择（浅色 / 深色 / 跟随系统）
- 语言设置
- 字体选择
- Markdown / todo.txt / Zim / AsciiDoc 等格式的配置项
- 底部操作栏自定义顺序
- Snippets 目录里的内容
- 收藏的文件夹列表
- 各种格式的高级开关（Markdown Math、行号等）
这些设置项多了 50+ 项。换手机、系统重置、Markor 更新出问题时，手动重设一遍会很痛苦。v2.7 新增的设置备份就是解决这个问题的。
备份设置
操作步骤
- 打开 Settings
- 滚动到底部，找到 Backup / Restore settings（或类似名称）
- 点 Backup → Markor 会提示选择保存位置
- 选一个方便找到的位置（比如 Notebook 根目录、Downloads 文件夹）
- Markor 生成备份文件（通常是
.markor-settings.json或.markor-backup）
备份文件里有什么
备份文件是一个 JSON 文件，包含：
{
"notebook_path": "/storage/emulated/0/Documents",
"quicknote_path": "/storage/emulated/0/Documents/quicknote.md",
"todotxt_path": "/storage/emulated/0/Documents/todo.txt",
"theme": "dark",
"language": "zh-CN",
"markdown_math": true,
"line_numbers": false,
"favourite_folders": [
"/storage/emulated/0/Documents",
"/storage/emulated/0/Documents/Notes"
],
"action_order_bottom_bar": ["bold", "italic", "h", "link", "image", ...],
"snippets": {
"meeting-header.md": "会议纪要..."
},
"encryption_password_hash": "..."
}注意：
- 主密码只存哈希值，不存明文——所以恢复后你还是需要自己记住并重新输入密码
- Snippets 内容是内联在备份里的，不需要单独复制
- 所有路径是 绝对路径，设备换了（特别是 Android 版本升级导致路径变化）后可能需要手动改
恢复设置
操作步骤
- 打开新设备上的 Markor（或重置后的 Markor）
- Settings → Backup / Restore
- 点 Restore → 选择之前保存的备份文件
- Markor 弹确认框 → 确认后恢复
- 重启 Markor（部分设置需要重启才能生效）
恢复后需要检查的项目
恢复后可能需要手动检查：
| 项目 | 为什么要检查 |
|---|---|
| Notebook 路径 | 不同设备 / Android 版本路径可能变了（比如旧路径是 /storage/emulated/0/Documents，新设备也是这个但实际不同） |
| QuickNote / ToDo / LinkBox 路径 | 同上 |
| 加密主密码 | 备份里只有哈希，恢复后需要在加密文件上重新输入密码 |
| 收藏文件夹 | 如果旧路径在新设备上不存在了，需要重新收藏 |
| 底部操作栏自定义 | 不同 Markor 版本的底部操作栏按钮可能增减，恢复顺序后缺的按钮会自动跳过 |
常见恢复场景
场景一：换了新手机
- 旧手机 → Settings → 备份 → 生成备份文件
- 旧手机把备份文件同步到 Syncthing / Dropbox / 传输给新手机
- 新手机 → 装 Markor → Settings → 恢复 → 选备份文件
- 新手机上 Markor 的所有设置项 立即和旧手机一模一样
场景二：Markor 更新后设置乱了
极少数情况下 Markor 更新后某些设置项可能丢失或重置：
- 之前有备份 → 直接恢复
- 没有备份 → 手动重新配置（痛苦教训，建议养成定期备份习惯）
场景三：系统重置 / 刷机
- 重置前 → Markor 设置备份
- 重置后 → 装 Markor → 恢复备份
- Notebook 文件通过同步客户端恢复 → 所有内容和设置全部还原
多久备份一次
| 建议 | 频率 |
|---|---|
| 定期备份 | 每月一次（或每两周一次） |
| 大变化后立即备份 | 改了 10 个以上设置项、新增了 5+ 个 Snippets、新建了多个收藏文件夹 |
| 换设备前必须备份 | 换手机前先备份 |
备份文件非常小（通常 < 100 KB），存起来不占空间。在 Syncthing / Dropbox 里放一份也不费带宽。
注意事项
⚠️ 备份不是迁移内容——备份文件里 只有设置项，没有你的 Markdown / todo.txt / Zim / Org-Mode 文件内容。内容文件需要通过同步客户端或手动复制来迁移。
⚠️ 不要把备份文件存到加密的 Markor 文件里——否则恢复时你需要先输入密码才能打开备份文件，形成鸡生蛋的问题。存到普通的 Markdown 文件里、或直接放 Downloads 目录。
⚠️ 加密主密码不随备份恢复——备份里存的是哈希（用来验证你输入的密码是否正确），不是明文。恢复后第一次打开加密文件时 Markor 会要求你重新输入密码。