通讯录

连接

在通讯录卡片上点按“连接”。面板会在你的 AddressBook 文件夹 ~/Library/Application Support/AddressBook 中打开：点按“选择此文件夹”。Exporter 只读取这一个文件夹，不会弹出权限请求，你的 iCloud 和 Exchange 名片也从这里读取。然后点按“选择导出文件夹”。

文件存放在哪里

每张名片一个 Markdown 文件，如 Anna Kowalski.md。两个同名的人各自会加上一个简短的 id 后缀，谁的文件都不会覆盖对方。直接位于个人文件夹中的文件夹，如 ~/Documents，会在其中新建一个 contacts-export 文件夹；更深层的文件夹，如 ~/Documents/contacts，会被直接使用。

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

标签页	文件存放在
全部、最近	导出文件夹的顶层
群组	groups/<group>/；同时属于两个群组的名片只写一次，放在第一个群组下
公司	companies/<company>/

切换标签页会在下次同步时移动文件，卡片会在标签页下方提示这一点。“最近”列出最近更改的 100 张名片；“群组”和“公司”的树形列表末尾分别是“未分组”和“无公司”。

导出的内容

卡片上勾选的名片，连同它们的所有字段。不会导出：Gmail 为你写过信的每个地址收集的、只有邮箱的条目。没有 vCard 或 CSV 导出：如需 .vcf，请在通讯录中使用“文件”>“导出”>“导出 vCard”。

格式

始终是 Markdown。

文件

每个键只在名片有对应值时出现。列表中的值带有自己的标签，如 +1 415 555 0123 (mobile)。

键	内容
title	姓名
aliases	昵称和婚前姓
id、source_url	名片的 id，以及一个在通讯录中打开它的 addressbook:// 链接
created、modified	名片的创建时间和最后更改时间
organization、job_title、department	工作信息
birthday	生日
email、phone	第一个电子邮件和电话，不带标签，方便模板使用
emails、phones、addresses、urls	每一项，带有自己的标签
social、im	社交资料和即时通讯账户
dates、relationships	其他日期和关联人姓名，如 father: Tom Kowalski
groups	名片所属的通讯录群组
conversations	同时导出了信息时，指向这张名片相关对话的链接

正文是姓名、职位行和名片的备注：

---
title: "Anna Kowalski"
id: "410FE041:ABPerson"
created: 2019-04-02T10:15:33
modified: 2026-08-30T19:02:11
source_url: "addressbook://410FE041:ABPerson"
organization: "Northwind Studio"
job_title: "Art director"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
phones:
  - "+1 415 555 0123 (mobile)"
groups:
  - "Studio"
---

# Anna Kowalski

Art director · Northwind Studio

Met at the print fair.

免费与解锁

在你勾选的名片中，前 100 张可以免费导出并持续免费同步，删除一张名片会让出它的名额；其余的需要一次性解锁（价格）。

同步和完全重新同步

首次点按“立即同步”后，只要 Exporter 在运行，编辑过的名片就会重写它的文件，已删除名片的文件会在下次同步时移除。

“完全重新同步”会先询问，然后只删除 Exporter 写入的文件，重新写出每张名片，并重新选定免费的 100 张。导出文件夹中的其他内容都会保留。

问题和修复

• “该文件夹中没有通讯录数据库（请选择 AddressBook 文件夹本身）”：再次点按“连接”，然后选择面板打开时所在的文件夹
• 文件移到了其他文件夹：卡片切换到了另一个标签页。回到你想要的标签页，然后点按“立即同步”
• 缺少一张名片：它超出了免费的 100 张、未被勾选，或者是来自 Gmail 的只有邮箱的条目
• 某张名片导出失败：上次同步 会显示一个红色的“详情”链接，列出失败的名片，每张都有一个“打开”链接