Danh bạ

Kết nối

Nhấn “kết nối” trên thẻ Danh bạ. Bảng chọn mở ra ở thư mục AddressBook của bạn, ~/Library/Application Support/AddressBook: nhấn “Chọn thư mục này”. Exporter chỉ đọc thư mục đó, không có hộp thoại xin quyền, và cũng đọc các thẻ iCloud và Exchange của bạn từ đó. Rồi nhấn “chọn thư mục xuất”.

Tệp được lưu ở đâu

Mỗi thẻ một tệp Markdown, Anna Kowalski.md. Hai người trùng tên đều được thêm hậu tố id ngắn, nên không tệp nào ghi đè lên tệp kia. Một thư mục nằm ngay trong thư mục người dùng, như ~/Documents, sẽ có một thư mục contacts-export bên trong; một thư mục sâu hơn, như ~/Documents/contacts, được dùng nguyên như vậy.

Tab mà thẻ đang mở cũng là cách sắp xếp thư mục:

tab	tệp được lưu vào
Tất cả, Gần đây	cấp trên cùng của thư mục xuất
Nhóm	groups/<group>/; một thẻ thuộc hai nhóm chỉ được ghi một lần, dưới nhóm đầu tiên
Công ty	companies/<company>/

Đổi tab sẽ di chuyển các tệp ở lần đồng bộ tiếp theo, và thẻ cho biết điều đó dưới các tab. Gần đây liệt kê 100 thẻ được thay đổi gần nhất; cây Nhóm và Công ty kết thúc bằng “Không thuộc nhóm nào” và “Không có công ty”.

Những gì được xuất

Các thẻ được đánh dấu trên thẻ Danh bạ, với mọi trường mà chúng có. Bị bỏ ra: các mục chỉ có email mà Gmail thu thập cho mọi địa chỉ bạn từng viết thư tới. Không có tính năng xuất vCard hay CSV: để có tệp .vcf, hãy dùng Tệp > Xuất > Xuất vCard trong Danh bạ.

Định dạng

Luôn là Markdown.

Tệp

Mỗi khóa chỉ xuất hiện khi thẻ có giá trị. Giá trị dạng danh sách mang theo nhãn của nó, như +1 415 555 0123 (mobile).

khóa	chứa
title	tên
aliases	biệt danh và tên thời con gái
id, source_url	id của thẻ, và một liên kết addressbook:// mở thẻ trong Danh bạ
created, modified	thời điểm thẻ được tạo và được sửa lần cuối
organization, job_title, department	các dòng công việc
birthday	ngày sinh
email, phone	email và số điện thoại đầu tiên, dạng đơn giản, để dùng trong mẫu
emails, phones, addresses, urls	tất cả, kèm nhãn
social, im	hồ sơ mạng xã hội và tài khoản nhắn tin
dates, relationships	các ngày khác và tên người liên quan, như father: Tom Kowalski
groups	các nhóm Danh bạ mà thẻ thuộc về
conversations	liên kết tới các cuộc trò chuyện của thẻ, khi Tin nhắn cũng được xuất

Phần thân là tên, dòng chức danh và ghi chú của thẻ:

---
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.

Miễn phí và mở khóa

100 thẻ đầu tiên trong số những thẻ bạn đã đánh dấu được xuất và tiếp tục đồng bộ miễn phí, và một thẻ bị xóa sẽ trả lại chỗ của nó; phần còn lại cần mở khóa một lần (bảng giá).

Đồng bộ và đồng bộ lại toàn bộ

Sau lần “đồng bộ ngay” đầu tiên, thẻ nào được sửa sẽ ghi lại tệp của nó trong lúc Exporter chạy, và tệp của một thẻ bị xóa sẽ bị xóa ở lần đồng bộ tiếp theo.

“đồng bộ lại toàn bộ” hỏi trước, rồi chỉ xóa các tệp Exporter đã ghi, ghi lại mọi thẻ và chọn lại 100 thẻ miễn phí. Mọi thứ khác trong thư mục xuất vẫn được giữ.

Sự cố và cách sửa

• “không có cơ sở dữ liệu danh bạ trong thư mục đó (hãy chọn chính thư mục AddressBook)”: nhấn “kết nối” lần nữa và chọn thư mục mà bảng chọn mở ra
• tệp bị chuyển sang thư mục khác: thẻ đã chuyển sang tab khác. Quay lại tab bạn muốn và nhấn “đồng bộ ngay”
• thiếu một thẻ: nó vượt quá 100 thẻ miễn phí, chưa được đánh dấu, hoặc là một mục chỉ có email từ Gmail
• một thẻ thất bại: lần đồng bộ cuối hiển thị một liên kết “chi tiết” màu đỏ với các thẻ bị thất bại và một liên kết “mở” tới từng thẻ