Notion

连接

在 Exporter 主页的「云端」下，点按 Notion 旁的「连接」。通过 Apple 登录，浏览器会打开 Notion 的页面，在那里选择允许 Exporter 读取的页面并允许访问。Exporter 只请求读取 Notion。回到 Exporter，选择文件存放的位置，然后点按「使用这个文件夹」。

Notion 令牌封存在 Exporter 的服务器上。Mac 只登录该服务器，从不持有令牌。

共享页面

只有与 Exporter 共享的页面会同步，连同它们下面的每个页面和数据库。之后要添加页面，请在 Notion 中打开它的 ⋯ 菜单，添加 exporter.dev 连接；它会在下次同步时到达。你不再共享的页面，会在下次每日检查时离开你的文件夹。

选择项目

选择页面列出所有已共享的页面和数据库，全部勾选，并有「全部」「页面」「数据库」三个标签。取消勾选你不需要的，它的文件就会被移除。

文件去哪里

直接位于个人文件夹下的文件夹（如 ~/Documents）会在其中生成一个 notion-export 文件夹。更深的文件夹按原样使用。

• 页面：放在 Notion 显示它们的文件夹中，以标题命名：Projects/Plan Q4.md。下面还有页面的页面，会在它的文件旁有一个同名文件夹。
• 数据库：一个以数据库命名的文件夹，每行一个文件，整个表格放在它旁边：Projects/Tasks/Write the plan.md 和 Projects/Tasks.csv
• Notion 托管的图片和文件：放在页面所在文件夹的 attachments/ 中，由页面链接

标题中的 / 和 : 会变成空格。同一文件夹中两个页面标题相同时，先创建的保留标题，另一个则加上其 ID 的前 6 个字符，放在括号中。

文件内容

页面的 front matter 包含 title、id、created、modified、source_url 和 parent，即它所在的页面或数据库。数据库行会按数据库的顺序，加上它的属性，名称与 Notion 中相同：文本、数字、日期、真或假，以及名称列表。然后是标题和以普通 Markdown 呈现的页面。标注是带图标的引用，折叠块是 details 块，颜色会被丢弃。指向另一个已导出页面的链接是指向其文件的相对链接。时间为 UTC。

数据库的 CSV 每个属性一列，每行一行，按时间从早到晚排列。

同步

Notion 把每次编辑、移动和删除告诉 Exporter 的服务器。服务器重写文件并通知 Mac，Mac 再下载，所以修改几分钟内到达；Notion 自己通知之前也要等一两分钟。改名或移动的页面会连同它的文件和附件一起移动。「立即同步」会先询问服务器，「完全重新同步」会重写每个文件。

Exporter Cloud

从第一次连接起 7 天免费。之后 Exporter Cloud 是 App Store 中的订阅：单独的 Notion，或包含 Linear、Notion 以及我们今后添加的所有云来源的 All Cloud，按月或按年。方案结束时同步停止，文件保留。30 天后服务器删除副本和令牌。

账户

「设置」›「账户」显示你登录所用的电子邮件。「退出登录」会保留连接以便下次登录。断开 Notion 会在 Notion 中撤销 Exporter 的访问权限，并删除 Exporter 在 exporter.dev 上的副本。「删除账户…」会断开所有工作空间，并删除服务器保存的一切。Mac 上的文件保留。

命令行

exporter export --source notion --dest <folder> 会把工作空间的文件写入你在命令行卡片中允许的文件夹。参见命令行。

问题与排查

• 缺少页面：在 Notion 中通过它的 ⋯ 菜单与 exporter.dev 连接共享它，确认它已勾选，然后点按「立即同步」。
• 图片显示为链接：Notion 没有交出它，所以文件改为链接到 Notion 中的那张图片。
• 卡片显示「重新连接…」：Notion 不再接受该连接，通常是因为它已在 Notion 设置中被移除。点按它再次允许访问。
• 卡片显示「登录…」：会话已结束。用同一个 Apple 账户登录，同步会继续。