MarginNote 5
📌 重点功能 · 同步 & 备份 设置 → 备份与恢复

把笔记放进可靠的备份位。
保留备份,跨设备接着学。

MN 提供 4 种自动备份位置(本地 / WebDAV / 百度网盘 / Google Drive)+ 完整导出整库包 + CloudKit 跨设备同步。下面是每种怎么开、各能放多大、出问题怎么办。

5 种存放方式,一种开一遍。

下面 5 张卡片,每张一种存放位置或导出方式。都在同一个入口设置:iPad / iPhone / Mac 上打开 MN → 设置 → 备份与恢复。

📁 自动备份到 本地文件夹

不依赖网络 · 最稳 · 不占云盘配额

  1. 打开 MN → 设置 → 备份与恢复
  2. 下滑找到 "备份位置",选 "本地文件夹"
  3. 选好你想放的目录(iPad 上是"文件"App 里的文件夹;Mac 上是 Finder 任意位置)
  4. 选频率:仅手动 / 每小时 / 每 6 小时 / 每 12 小时 / 每天 / 每周

备份包格式:.marginbackupall。包文件归你管——存哪由你决定,系统不强制上传任何云端。

🗄️ 自动备份到 WebDAV / NAS

群晖 / 自建 WebDAV / 坚果云 / 公司私有云

  1. 设置 → 备份与恢复 → 备份位置选 "WebDAV 服务器"
  2. 下方"WEBDAV 配置"区域,填 服务器 URL(如 https://dav.example.com/)、用户名、密码
  3. 点 "测试连接" 确认能连上
  4. 选频率即可——MN 会在你设定的时间点自动推送备份包到 WebDAV

支持 HTTPS 自签证书;坚果云需要用"应用密码"而不是登录密码;群晖 / 威联通的内置 WebDAV 直接用账号即可。

☁️ 自动备份到 百度网盘

国内首选 · 容量大 · 扫码登录

  1. 设置 → 备份与恢复 → 备份位置选 "百度网盘"
  2. 点 "登录百度网盘"——优先扫码(用手机百度网盘 App 扫一下);同一面板也支持账号密码登录
  3. 授权成功后回到 MN,选频率即可
  4. 第一次会先把当前学习集 / 卡片组的内容打包上传一次(首传偏慢,后续只传变化部分)

备份包会放在你百度网盘的 MarginNote 专属目录下;普通用户百度网盘容量足够放多个学习集的完整备份。

☁️ 自动备份到 Google Drive

海外首选 · OAuth 授权 · 跨设备访问

  1. 设置 → 备份与恢复 → 备份位置选 "Google Drive"
  2. 点登录,跳到 Google OAuth 授权页,用你的 Google 账号授权 MN 写入 Drive 中的 MN 专属目录
  3. 回到 MN,选频率
  4. 需要稳定的国际网络;首次授权后 token 自动续期,不用反复登录

备份包大小受 Google Drive 配额限制(免费 15 GB,含 Gmail / Photos);建议把"包含原始 PDF / 视频"按需勾选,纯笔记数据通常 < 200 MB。

💾 手动 完整导出 整库包

长期就有 · 手动触发 · 迁移到新设备最稳

  1. 设置 → 备份与恢复 → 上方 "完整导出" 卡片
  2. 三选一粒度:
    • 数据库 + 全部文档 + 历史版本——全量打包,迁移到新设备首选
    • 数据库 + 学习集文档——只带与学习集关联的 PDF,节省体积
    • 仅导出数据库——只导出笔记元数据,不含 PDF
  3. 导出 MarginNoteBackup(yyyy-MM-dd-HH-mm-ss).marginbackupall,存到任意位置
  4. 恢复:新设备装 MN → 设置 → 备份与恢复 → 选择本地的 .marginbackupall 文件 → 导入

这是 MN 一直就有的机制,不依赖 4.3 后的新架构。自动备份建议平时跑着,完整导出建议每隔几周手动做一次放外部 SSD。

📌 设置入口:MN → 设置 → 备份与恢复。可以同时开多种,建议至少开"本地 + 一个云端"——一份在你能控制的位置,一份在云端做异地容灾。

MarginNote iPad 设置页 · 备份与恢复面板:完整导出(三种粒度)+ 自动备份(WebDAV / 本地 / 百度网盘 / Google Drive 四选)+ WebDAV 配置(服务器 URL / 用户名 / 密码 / 测试连接)
设置 → 备份与恢复 的真实界面(iPad)。完整导出三种粒度 + 自动备份四个位置 + WebDAV 配置都在这一屏。
长期已有 · 跨设备同步

用 iCloud CloudKit 在你的设备之间自动同步。

这套是 Apple 自家的 iCloud 同步,不依赖第三方账号。跟"备份"是两件事——CloudKit 让你的 iPad 和 Mac 在同步完成后对齐当前最新状态;备份是把历史快照存到你能找回的地方。两个都开最稳。

怎么开

设置 → 云同步 → 选 CloudKit 同步。

默认登录哪个 iCloud 账号就用哪个;同一 Apple ID 的设备会自动接入。

什么时候用 / 不用

用:iPad + Mac 双机轮流学习;希望随手切设备继续。
不用:单设备用户;笔记库非常大且 iCloud 配额已满。

同步缓存重置

若出现卡顿或异常,可在设置 → 云同步中查看重置同步缓冲选项。重置前先确认已保存独立备份,并阅读当前版本的确认提示;重新比对与完成时间取决于资料和同步状态。

每学习集独立启用

可选"为每个学习集手动启用"或"自动启用":手动给你更细的控制(不重要的学习集不占配额);自动适合"新建一个就同步一个"的用户。

MarginNote 5 新增

同步到哪一步,首页上就能看到。

MarginNote 5 没有换同步通道,仍然是 iCloud CloudKit。变化是你能看到同步的状态,出问题时有地方查。

首页同步状态 · 同步中心

首页显示 iCloud 同步的状态。点开是同步中心:笔记和原文档分开显示,附最近活动和处理建议,可以导出诊断报告。

应用改动前先存历史版本

应用 iCloud 上的改动之前,MarginNote 先保存一份历史版本。手动同步结束后会告诉你这次做了什么。

原文档还在路上

如果原始文档还没到你的设备上,你可以继续使用笔记和脑图。同步中心会显示文档还在从 iCloud 到达。

修复的问题

修复了关闭单个学习集同步、上传途中切换模式等情况下误删云端笔记的问题。手动同步会补传云端缺少的卡片和被引用的文档笔记本,修复丢卡和引用断开。

网络断 / 冲突 / 配额满 / 跨账号——都有兜底。

同步备份系统的真实价值不在它正常工作时,而在它出问题时。这一节讲清楚每种失败模式的恢复路径——你应该知道当 things go wrong 时按哪个按钮。

同步状态栏

正在检查更新 / 准备下载 / 下载中(n/m)/ 准备上传 / 上传中(n/m)/ 同步完成 / 同步失败

每个状态对应实际的同步阶段——没在猜,在算。

重置同步缓冲

CloudKit 同步出现卡顿或异常时,可在 设置 → 云同步 重置同步缓冲——所有数据会重新比对。是核选项,按钮有二次确认。

手动同步备份

手动同步前会尝试保存本地数据库备份。可恢复的范围以实际成功生成并保留的备份为准;自动备份不能替代独立保存的重要资料副本。

管理 CloudKit 区域

用过 CloudKit 同步后想清空云端可见数据,可在设置里手动删除 CloudKit zones——释放 iCloud 配额,不影响本地。

有些事 MN 不承诺。

"绝不丢数据"听起来好——但工程上没有任何系统能这么承诺。MN 选择不夸口,而是把每层兜底机制讲清楚。

不是实时协同(CRDT / OT)

同步是基于变更追踪的最终一致——同步完成时间受网络、资料量和设备状态影响。不是 Google Docs 那种"两个人同时编一段、字符级合并"。MN 不做实时协同。

本地保护需要快照已生成

"架构本身保护数据"建立在自动快照默认开启的前提上。如果你手动关掉自动快照、且没跑过任何手动 / 基线快照,崩溃前一秒的状态代码侧没有保证能恢复。可恢复的是"最近一份完整快照"。

不承诺零数据丢失

云盘服务故障 / 设备彻底损坏 / Apple ID 异常 / 操作误删——都可能发生。新架构 + 自动备份 + 完整导出层层兜底降低风险,但不打"绝对安全"包票。建议定期完整导出 + 一份保留在你能控制的位置(外部 SSD / 自己的 NAS / 不同账号的云盘)。

关于版本:本页讲到的"新数据架构"自 MN 4.3 起引入。

FOR THE CURIOUS · 深入 为什么 MN 4.3 重做了底层数据架构?点开看 ▾

下面这部分是给好奇 / 工程背景的读者看的——讲清楚 MN 4.3 引入的新数据架构是什么、为什么这么改、跟之前的 CloudKit 同步有什么本质区别。不影响日常使用——上面那些步骤照做就行。

MN 3.x → 4.2:CloudKit 同步(record 级)+ 完整导出 → MN 4.3+新一代数据架构 · 自动备份 · 本地完整性

MarginNote 数据架构与三类应用 本地数据 → 数据架构(BackupStorage 内容寻址对象池 + Manifest 版本化)→ 两类应用:本地完整性 / 自动备份。Full Export 与 CloudKit 同步是兼容保留的旧机制。 本地 MarginNote 数据 学习集 · 卡片 · 摘录 · 脑图 · 手写图层 · 复习 · 文档 MN 4.3+ 全新 数据架构 · BackupStorage + Manifest 把 git 的版本管理方式用在学习数据上 内容寻址对象池 SHA-256 + atomic write Manifest 版本化 versionNumber + deviceId SQLite 事务 快照元数据原子提交 应 用 两 处 应用 ① 本地完整性 默认开启 5 分钟 idle 自动出快照 同步前 / 冲突前 自动出快照 应用 ② 自动备份 默认可开 按频率自动跑 · 增量 · 版本化 4 个目的地后端 → 崩溃 / 写错可恢复 不开同步、不开外部备份也保护 → 从已保存的完整版本恢复 本地 · WebDAV · 百度 · Google 兼 容 保 留 · LEGACY 完整导出(Full Export) 手动整库一次性打包,独立于新架构 .marginbackupall · 三种粒度 迁移 / 长期归档场景仍是首选 CloudKit 同步 老牌 record 级同步(自 2015 起) CloudKit 私有库 · 同 Apple ID 设备 iPhone · iPad · Mac 跨设备同步 蓝 = MN 4.3+ 新架构 黄 = MN 4.2 及之前的兼容保留

中心是数据架构本身(MN 4.3 引入),它被两处复用:本地完整性安全网 / 自动备份。下方完整导出和 CloudKit 同步是 MN 4.2 及之前就存在的旧机制,与新架构并存。

全新 · MN 4.3 起
把 git 那套版本管理方式,
用在你的学习数据上。

从 MN 4.3 起,MN 引入了一套版本化数据底层——不只是"备份"或"同步",而是被本地完整性和自动备份共用的底座。这是 MN 这一代的架构升级。

01

对象池

内容寻址 SHA-256

每条数据按 SHA-256 hash 寻址存储——相同内容只存一份。文件用 writeToFile:atomically:YES;索引插入失败时删除刚写入文件回滚。

  • Loose 对象 + Pack 文件(>1000 / >50MB 触发打包)
  • 对象损坏可重建索引
02

Manifest

snapshot 级原子单元

每个学习集快照是一个 Manifest,记录 versionNumber + deviceId + 内容 hash + 依赖关系。同步和恢复以 manifest 为单位,不再是字段或 record 级。

  • 这是新架构的核心——一份学习集要么全成、要么全失败
03

SQLite 事务

元数据原子提交

快照元数据写入用 SQLite transaction。要么这次快照完整入库,要么没出现——不会留下半成品 manifest。

  • BackupSnapshots_v4.sqlite(schema v6)

⚠ 这套架构不是 CoreData + 对象池 + 快照 DB 的全局单事务——是"对象池写原子 + manifest 写原子"两件事各自原子。整体体验是版本库式安全网,不是数据库级 ACID 日志。

MN 4.3+ 新增
不开同步、不开外部备份——
架构本身就在保护你的数据。

"丢手写""脑图乱掉""崩溃后笔记不见"是 MN 用户长期反馈的几大痛点。新架构在本地就以快照形式承接编辑——不需要你为它配置任何远程目的地。

默认行为

5 分钟 idle 出快照

每次编辑学习集 → 标记 dirty → 编辑停下 5 分钟 → 系统在本地版本库出一份不可变快照。

  • 同步前自动出快照(默认开)
  • 冲突前自动出快照(默认开)
  • 同步后自动出快照(默认关,避免重复)
崩溃恢复

对象 + 索引可重建

对象内容 hash 校验失败时——比如硬盘扇区坏 / 文件损坏——可以触发 verifyIntegrity + rebuildIndex 重建对象索引。

  • UI 入口:修复缺失基线版本(推荐),仅在检测到未覆盖学习集时显示

⚠ 诚实边界:上面这套保护建立在自动快照默认开启的前提上。如果你手动关掉自动快照、且没有跑过任何手动 / 基线快照,那么"崩溃前一秒的状态"代码侧没有保证能恢复。架构提供的是最近一份完整快照之内的回溯能力,不是逐键不可丢失。

不只是好用——更要放心。

下载 MarginNote 5,把你的笔记交给一个把"数据安全"当作明确的工程任务来做的工具。