# 將聯絡人匯出為 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-hant/docs/contacts) · 指南: [聯絡人到 Obsidian](https://exporter.dev/zh-hant/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-hant/contacts
every page: https://exporter.dev/llms.txt