# 연락처

연결부터 문제 해결까지, 연락처 내보내기가 작동하는 방식입니다.

## 연결

연락처 카드에서 “연결”을 누릅니다. 패널이 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` | 메시지도 내보냈을 때, 카드의 대화로의 링크 |

본문은 이름, 직장 줄, 카드의 메모입니다:

```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: "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개는 무료로 내보내고 계속 동기화되며, 삭제한 카드는 그 자리를 돌려줍니다. 나머지에는 일회성 잠금 해제가 필요합니다([가격](https://exporter.dev/pricing)).

## 동기화와 전체 재동기화

처음 “지금 동기화”를 누른 뒤로는 Exporter가 실행 중인 동안 편집한 카드가 해당 파일을 다시 쓰고, 삭제한 카드의 파일은 다음 동기화 때 빠집니다.

“전체 재동기화”는 먼저 확인을 요청한 다음, Exporter가 쓴 파일만 지우고 모든 카드를 다시 쓰며 무료 100개를 다시 고릅니다. 내보내기 폴더의 다른 것은 그대로 남습니다.

## 문제와 해결 방법

- “해당 폴더에 연락처 데이터베이스가 없습니다 (AddressBook 폴더 자체를 선택하세요)”: “연결”을 다시 누르고, 패널이 열린 폴더를 선택하세요
- 파일이 다른 폴더로 옮겨짐: 카드의 탭이 바뀌었습니다. 원하는 탭으로 돌아가 “지금 동기화”를 누르세요
- 카드가 없음: 무료 100개를 넘었거나, 선택 해제되었거나, Gmail이 모은 이메일만 있는 항목입니다
- 실패한 카드: “마지막 동기화”에 빨간 “자세히” 링크가 표시되며, 실패한 카드와 각 카드의 “열기” 링크가 나옵니다

## Related

- [Contacts](https://exporter.dev/contacts): Every contact card as a Markdown file
- [Contacts guides](https://exporter.dev/guides/contacts): People notes in Obsidian
- [Messages](https://exporter.dev/docs/messages): Conversations, media, fields and fixes

---

human version: https://exporter.dev/ko/docs/contacts
every page: https://exporter.dev/llms.txt