聯絡人

連接

在聯絡人卡片上按「連接」。面板會在你的 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、只有電子郵件的項目
• 有卡片失敗：上次同步 會顯示紅色的「詳細資訊」連結，列出失敗的卡片，每張都有一個「打開」連結