# Apple 备忘录

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`：

```markdown
---
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 条备忘录可以免费导出并持续免费同步；之后的新备忘录需要一次性解锁（[价格](https://exporter.dev/pricing)）。

## 同步和完全重新同步

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

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

## 问题和修复

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

## Related

- [Export Apple Notes to Markdown](https://exporter.dev/notes): Apple Notes as Markdown, kept in sync
- [Apple Notes guides](https://exporter.dev/guides/notes): Obsidian, backups, Claude and Wander
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

human version: https://exporter.dev/zh-hans/docs/notes
every page: https://exporter.dev/llms.txt