# 开始使用

连接一个应用，选择一个文件夹，点按“立即同步”。

Exporter 读取你 Mac 上的应用，把读到的内容写成文件，存放在你选择的文件夹中，并在你继续使用这些应用时让文件保持最新。每个应用的设置方式都一样：连接它，选择它的导出文件夹，点按“立即同步”。

## 安装

从 Mac App Store 获取 Exporter（[下载](https://exporter.dev/download)），它在那里的名称是“Exporter: Notes to Markdown”。它需要 macOS 15 或更高版本，并在搭载 Apple 芯片的 Mac 上运行。无需账户，也无需登录任何东西。

## 连接一个应用

“主页”上每个应用一张卡片；只有当 Bear 和 Logseq 已安装时，它们才会有卡片。

1. 在卡片上点按“连接”。首次启动时，欢迎卡片上的“连接 Apple 备忘录”对 Apple 备忘录的作用相同。
2. 一个文件夹面板会打开，并且已经位于该应用的数据文件夹中。不要选择其中的任何内容，直接点按“选择此文件夹”。Logseq 和文档则要求你选择自己的文件夹：你的图谱，或你的文档所在的文件夹。

这就是全部的权限：不需要完全磁盘访问权限，也不会出现 macOS 提示。Exporter 以只读方式读取这一个文件夹，并记住它。从欢迎卡片连接 Apple 备忘录后，会打开 Apple 备忘录卡片，进行下一步。

## 选择导出文件夹

点按“选择导出文件夹”，选择这个应用的文件存放位置。文件夹所在的层级决定了文件最终存放的位置：

| 你选择的是 | 文件存放在 |
| --- | --- |
| 你的个人文件夹，或直接位于其中的文件夹，如 `~/Documents` 或 `~/Dropbox` | 在其中新建的子文件夹，如 `~/Documents/notes-export` |
| 更深层的文件夹，如 `~/Documents/notes` | 该文件夹本身 |

卡片上的 `导出到` 一行显示实际的文件夹，“更改…”可以选择其他文件夹。给每个应用各自的文件夹，并把它们并排放置，如 `~/Documents/notes` 和 `~/Documents/messages`：[MCP 服务器](https://exporter.dev/docs/mcp)只提供与 Apple 备忘录导出文件夹并排放置的导出文件夹。

## 运行首次导出

点按“立即同步”。写入期间你可以关闭窗口。完成后，`上次同步` 会显示时间和已导出的条目数量，这个应用的实时同步也已打开：从此以后，应用中的更改会自动写入对应的文件。

每个导出文件夹还会有一个 `.exporter/`，记录每次运行，“导出日志”（时钟图标）显示的就是这些记录。文件夹中还会有什么，以及文件中的每个字段，因应用而异：每个应用在文档中都有自己的页面，例如 [Apple 备忘录](https://exporter.dev/docs/notes)。

## 哪些会持续运行

- 关闭窗口不会停止任何东西：应用会继续同步，程序坞中保留它的图标，直到你退出它。退出会停止实时同步和 MCP 服务器
- “设置”>“登录时启动”会在重启后启动 Exporter，同步会自动继续
- “设置”>“菜单栏模式”会添加一个显示每个应用状态的菜单栏图标，启动时也不再打开窗口
- 实时同步没有开关。它在某个应用首次点按“立即同步”时开始，在你点按“断开连接”时停止；断开连接会忘记该应用的文件夹，已导出的文件则留在原处
- 应用退出时，从[命令行](https://exporter.dev/docs/cli)运行 `exporter sync` 可以补上

## 解锁

每个应用在免费额度内都可以免费导出（Bear 和 Logseq 不限数量），已导出的内容会一直免费同步。应用卡片上的解锁按钮是针对该应用的一次性购买，不是订阅，“恢复购买”可以在另一台 Mac 上恢复它（[价格](https://exporter.dev/pricing)）。

## 完全重新同步会删除什么

卡片上的“完全重新同步”会先询问，然后只删除 Exporter 在导出文件夹中写入的文件。接着它会重新导出，并重新选定免费的条目。文件夹中的其他内容都会保留：你自己的笔记、Obsidian 仓库的 `.obsidian`、一个文档文件夹。尽管如此，还是请给每个导出单独一个文件夹，让它的文件和你的文件互不干扰。

普通同步只会删除 Exporter 自己写入、且已不再由任何条目生成的文件。

## 备份

导出文件夹是一个镜像：你在应用中删除的条目，会在下次同步时从中删除，所以它不是存档。如需永不改变的带日期副本，[备份 Apple 备忘录](https://exporter.dev/guides/notes/back-up-apple-notes)介绍了如何用命令行设置每晚快照。恢复就是把文件复制回去：Exporter 从不写入你的应用。

## Related

- [Apple Notes](https://exporter.dev/docs/notes): Folders, fields, HTML and fixes
- [Guides](https://exporter.dev/guides): One job each, step by step
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

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