# 将通讯录导出为 Markdown

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

[下载 Mac 版](https://apps.apple.com/us/app/exporter-notes-to-markdown/id6741618455?mt=12)

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

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

`Anna Kowalski.md`

```markdown
---
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`，编辑过的卡片会重写它的文件。

工作原理: [文档：通讯录](https://exporter.dev/zh-hans/docs/contacts) · 指南: [通讯录导入 Obsidian](https://exporter.dev/zh-hans/guides/contacts/contacts-to-obsidian)

## 常见问题

### 为什么不直接用 vCard？

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

### 哪些是免费的？

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

### 会上传什么吗？

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

## 与其他方式对比

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

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

## 让 Claude 帮你查找联系人

导出的卡片可以通过 Exporter 的本地 MCP 服务器搜索。[进行设置](https://exporter.dev/docs/mcp)。

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

```sh
claude mcp add --transport http exporter http://localhost:8744/mcp
```

## Related

- [Messages](https://exporter.dev/messages): Every conversation as a file
- [Contacts to Obsidian](https://exporter.dev/guides/contacts/contacts-to-obsidian): A note per person, fields as Properties
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents

---

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