연락처
연결부터 문제 해결까지, 연락처 내보내기가 작동하는 방식입니다.
연결
Exporter 홈에서 연락처 옆의 “연결”을 누른 다음 “연락처 폴더 열기”를 누릅니다. 패널이 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이 모은 이메일만 있는 항목입니다
- 실패한 카드: “마지막 동기화”에 빨간 “자세히” 링크가 표시되며, 실패한 카드와 각 카드의 “열기” 링크가 나옵니다