将通讯录导出为 Markdown

每张联系人卡片变成一个包含所有字段的 Markdown 文件，并在你编辑时保持同步。

一张联系人卡片，变成一个文件。

每个字段都在 front matter 中，是 Obsidian 属性面板可以编辑的值和列表。正文是姓名、职位行和卡片的备注。

Anna Kowalski.md

---
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: "艺术总监"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
emails:
  - "anna@northwind.example (work)"
phones:
  - "+1 415 555 0123 (mobile)"
addresses:
  - "18 Harbor Street, San Francisco, CA, 94107, United States (work)"
groups:
  - "工作室"
conversations:
  - "[[messages/Anna Kowalski]]"
---

# Anna Kowalski

艺术总监 · Northwind Studio

在印刷展上认识。偏爱哑光纸。

导出的内容

Gmail 为你写过信的每个地址收集的、只有邮箱的条目会被排除。

卡片上的每个字段

公司、职位、生日、电子邮件、电话、地址、网站、社交资料、日期、关联人姓名。

保留标签

每个值都带着自己的标签，例如 +1 415 555 0123 (mobile)，第一个电子邮件和电话还会作为普通的 email 和 phone 字段，方便模板使用。

群组

卡片所属的通讯录群组，以列表形式写在 front matter 中。

人和他们的对话

如果也导出了信息，卡片会列出相关对话，每个对话也会链接回这张卡片。

链接回去

source_url 可在“通讯录”中打开这张卡片。

稳定的文件名

两个同名的人各自会加上一个简短的 id 后缀，谁的文件都不会覆盖对方。

工作原理

1连接通讯录
面板会在你的 AddressBook 文件夹中打开：点按“选择此文件夹”。Exporter 只读取这一个文件夹，不会弹出权限请求。
2选择要导出的人
按群组或公司勾选卡片，或者导出所有卡片。通讯录卡片当前所在的标签页决定文件夹：在“群组”或“公司”标签页上，每个文件会放进对应群组或公司的文件夹。
3自动同步
点按“立即同步”。每张卡片变成 Name.md，编辑过的卡片会重写它的文件。

工作原理: 文档：通讯录指南: 通讯录导入 Obsidian

常见问题

还有问题？联系我们

为什么不直接用 vCard？

要把卡片移到另一个通讯录，就用 vCard：在“通讯录”中选择联系人，然后选择“文件”>“导出”>“导出 vCard”。.vcf 文件是为导入而设计的。Markdown 文件则用于阅读、搜索和链接。

哪些是免费的？

前 100 位联系人可以免费导出并持续免费同步。解锁通讯录是在 Exporter 中的一次性购买。

会上传什么吗？

不会。Exporter 在你的 Mac 上读取联系人并写入文件。没有账户，没有服务器。

与其他方式对比

Apple 的导出方式是 vCard，要把卡片移到另一个通讯录时，它是正确的选择。

功能	Exporter	vCard 导出	复制粘贴
一次导出所有卡片	是	是	否
易读的 Markdown，每人一个文件	是	否	手动
字段即 Obsidian 属性	是	否	否
关联你的对话	是	否	否
卡片变化时保持同步	是	一次性	否
可导入另一个通讯录	否	是	否
价格	100 位联系人免费，之后一次性购买	免费	免费

让 Claude 帮你查找联系人

导出的卡片可以通过 Exporter 的本地 MCP 服务器搜索。进行设置。

连接 Claude Code。

然后问：“Anna 的生日是哪天？我们上次聊天是什么时候？”Claude 会读取这张卡片以及它链接的对话。

$ claude mcp add --transport http exporter http://localhost:8744/mcp