Apple 备忘录

连接

在 Apple 备忘录卡片上点按“连接”（首次启动时，点按欢迎卡片上的“连接 Apple 备忘录”）。面板会在 ~/Library/Group Containers/group.com.apple.notes 中打开：不要打开任何内容，直接点按“选择此文件夹”。Exporter 以只读方式读取那里的备忘录数据库。然后点按“选择导出文件夹”，再点按“立即同步”。

文件存放在哪里

直接位于个人文件夹中的文件夹，如 ~/Documents，会在其中新建一个 notes-export 文件夹；更深层的文件夹，如 ~/Documents/notes，会被直接使用。导出到 一行显示实际的文件夹。

卡片当前所在的标签页也决定了文件夹结构：

标签页	文件存放在
文件夹	Apple 备忘录自己的文件夹树
标签	以备忘录第一个被勾选的标签命名的文件夹；没有被勾选标签的备忘录不会导出
智能	以其智能文件夹命名的文件夹

在这些标签页之间切换，会在下次同步时移动所有文件，卡片会在标签页下方提示这一点。“共享”“置顶”“最近”和“常看”是列表：在那里勾选，等同于在“文件夹”上勾选。

文件以备忘录的标题命名，去掉 .，并把 / 和 : 换成 _。同一文件夹中两条同名的备忘录都会加上其 id 的六个字符，如 Meeting-3f9a1c.md。备忘录旁边还有：

• attachments/，位于每个文件夹的备忘录旁边
• bases/：all-notes.base、photo-notes.base 和 all-attachments.base，供 Obsidian 的 Bases 使用的视图，每次导出都会重写
• .exporter/：上次运行的 last-export.json 和 last-export.md，保存最近 50 次运行的 history/，以及 files.json，即 Exporter 写入的文件列表

导出的内容

卡片上勾选的文件夹或标签中的每条备忘录。首次载入时会勾选全部内容，之后出现的文件夹和标签也会自动勾选；你取消勾选的会保持取消勾选。

不会导出：

• 锁定的备忘录，也就是设有密码的备忘录
• Apple 备忘录尚未从 iCloud 下载到这台 Mac 上的备忘录
• 最近删除
• 标有“因此不会导出任何内容”的智能文件夹中的备忘录：它的搜索条件无法读取，所以请在“文件夹”上勾选这些备忘录

在文件中，清单变成 - [ ] 和 - [x]，表格变成 Markdown 表格，高亮变成 ==text==，指向其他备忘录的链接变成 [[wikilinks]]。你的 #标签 保留在正文中。下划线和文字颜色会被舍弃。

附件

图片、PDF、扫描件和手绘图会复制到 attachments/，并用 ![[attachments/...]] 嵌入在它们原来的位置。手绘图会变成它的图片，Apple 识别出的手写文字会引用在下方。文件不在这台 Mac 上的附件会被跳过，“导出日志”会将其列为“source file not found”。

Markdown 和 HTML

默认是 Markdown。格式 一行上的“切换为 HTML”会改为每条备忘录写一个网页：样式内嵌其中，所以不会从互联网载入任何内容；备忘录的 id 和日期放在顶部，代替 front matter；备忘录之间的链接变成页面之间的链接；附件复制到页面旁边的 attachments/ 并由页面链接，所以移动页面时要连同那个文件夹一起移动。

一次只用一种格式。同步只会删除它所写格式的旧文件，所以切换后另一种格式的文件会留下来：请给每种格式单独一个文件夹。MCP 服务器只读取 Markdown。

文件

front matter 的键始终按以下顺序排列，不适用时省略：

键	内容
title	备忘录的标题
id	Apple 备忘录为这条备忘录分配的 id
created、modified	Apple 备忘录自己的时间，不带时区，这是 Obsidian 读作日期的格式
source_url	一个在 Apple 备忘录中重新打开这条备忘录的 notes:// 链接
pinned、shared	备忘录被置顶或共享时为 true
collaborators	共享备忘录的共享对象
cover	第一张图片，以 wikilink 指向它在 attachments/ 中的副本
links	备忘录中的网页链接

没有 tags 键。“旅行”>“挪威”中的一条备忘录，写成 Travel/Norway/Bike tour, day 2.md：

---
title: "Bike tour, day 2"
id: "5B7E2C19"
created: 2025-06-21T20:14:02
modified: 2025-06-22T08:03:47
source_url: "notes://showNote?identifier=5B7E2C19"
links:
  - "https://www.visitnorway.com/"
---
# Bike tour, day 2

From Voss to Flåm. Ferry times are in [[Bike tour, day 1]].

![[attachments/Drawing 3f9a1c.png]]

免费与解锁

前 100 条备忘录可以免费导出并持续免费同步；之后的新备忘录需要一次性解锁（价格）。

同步和完全重新同步

首次点按“立即同步”后，只要 Exporter 在运行，无论窗口打开还是关闭，你在 Apple 备忘录中的每次编辑都会写入对应的文件。退出应用会停止同步；exporter sync 可以补上。你删除、重命名或移动一条备忘录时，下次同步会删除它的旧文件，而且只删除列在 .exporter/files.json 中的文件。

“完全重新同步”会先询问，然后只删除 Exporter 写入的文件，重新导出，并重新选定免费的 100 条。导出文件夹中的其他内容都会保留：你自己的笔记，以及仓库的 .obsidian。

问题和修复

• “这不是 Apple 备忘录的文件夹”：你选择了其他文件夹。点按“重试”，然后不要打开任何内容，直接点按“选择此文件夹”
• 缺少一条锁定的备忘录：在 Apple 备忘录中移除锁定。“设置”>“备忘录数据库诊断”会统计锁定的备忘录数量
• 缺少 iCloud 备忘录：打开 Apple 备忘录，让它完成同步，然后查看卡片上的 已选 数量
• 文件移到了其他文件夹：卡片切换到了另一个标签页。回到你想要的标签页，然后点按“立即同步”
• 某条备忘录导出失败：上次同步 会显示一个红色的“详情”链接。“Apple 备忘录当时正在写入这条备忘录，它会在下次同步时导出”会自行消失；如果“无法从数据库读取备忘录”一直失败，请从“设置”>“备忘录数据库诊断”发送报告，并附上这条备忘录的标题
• 缺少一张图片：在 Apple 备忘录中打开这条备忘录，让它的文件下载下来，然后再同步一次
• 编辑没有出现：Exporter 必须在运行，而且这条备忘录已被勾选，并在免费额度之内