# Mail

Mail 내보내기가 어떻게 되는지, 연결부터 문제 해결까지.

## 연결

Exporter 홈에서 Mail 옆의 「연결」을 누르고(연결하기 전에는 「앱 N개 더」 안에 있습니다), 이어서 「Mail 폴더 열기」를 누릅니다. 패널은 `~/Library/Mail`에서 열립니다. 그 폴더 자체를 선택하세요. 그다음 파일이 저장될 위치를 고르고 「이 폴더 사용」을 누릅니다.

Exporter는 허용한 폴더를 통해 Mail이 Mac에 보관하는 메일을 읽습니다. 메일 권한도, 계정도, 전체 디스크 접근 권한도 묻지 않습니다.

## 이메일 선택

선택 페이지에는 탭이 두 개 있고, 두 탭에서 모두 체크된 이메일이 동기화됩니다.

- 종류: Mail이 스스로 나누는 탭. 기본, 거래, 업데이트, 프로모션, 그리고 나머지를 위한 「Mail에서 분류 안 됨」. 업데이트와 프로모션은 체크가 풀린 채 시작합니다
- 계정: 각 계정이 주소로 표시되고, 그 안에 메일상자가 있습니다. 임시 보관함과 휴지통은 체크가 풀린 채 시작합니다

삭제된 메일, 스팸, 정크는 무엇이 체크되어 있든 동기화되지 않습니다. 목록 위의 개수는 두 탭이 함께 남기는 이메일 수입니다.

## 파일이 가는 곳

이메일 하나당 Markdown 파일 하나, 이름은 날짜, 제목, 번호입니다: `2026-09-28 Your order has shipped 491560.md`. 홈 폴더 바로 아래의 폴더, 예를 들어 `~/Documents`를 고르면 그 안에 `mail-export` 폴더가 생기고, 더 깊은 폴더는 그대로 쓰입니다.

카드의 「옵션…」에 있는 「정리」가 폴더를 정합니다.

- 날짜별: `2026/09/`, 연도와 월마다 폴더 하나
- 계정별: 계정마다 폴더 하나, 그 안에 연도
- 종류별: `primary/`, `transactions/`, `updates/`, `promotions/`, `unsorted/`, 그 안에 연도

「정리」를 바꾸면 다음 동기화에서 모든 파일이 옮겨집니다. 예전 자리에는 아무것도 남지 않습니다.

## 파일

프런트매터에는 `from`, `to`, `mailbox`, `read`, 깃발이 있으면 `flagged`, `account`, `kind`가 담기고, `source_url`은 Mail에서 그 이메일을 엽니다. 그다음 제목이 타이틀이 되고 본문은 Markdown이 됩니다: 제목, 목록, 표, 링크. 첨부 파일은 Mail에 남습니다. Mail이 본문을 다운로드하지 않은 이메일은 파일 안에 그렇다고 적힙니다.

## 무료와 잠금 해제

최근 이메일 1,000개는 무료로 내보내지고 계속 동기화됩니다. Mail 잠금 해제는 일회성 구매입니다. 잠금 해제한 뒤 「지금 동기화」를 누르면 체크된 나머지가 동기화됩니다. 큰 메일상자의 첫 동기화 도중에 종료해도 멈춘 곳에서 이어집니다.

## 동기화

Exporter가 실행 중인 동안 Mail의 인덱스를 지켜보며, 새 메일은 스스로 파일이 됩니다. 「지금 동기화」는 직접 실행하고, 「전체 재동기화」는 모든 파일을 다시 씁니다.

## 명령줄

`exporter sync --source mail`은 카드의 「지금 동기화」처럼 Mail을 동기화합니다. `exporter export --source mail --dest <folder>`는 「명령줄」 카드에서 허용한 폴더에 이메일을 쓰고, 카드 자체의 동기화는 건드리지 않습니다. [명령줄](https://exporter.dev/docs/cli)을 참고하세요.

## 문제와 해결

- 선택 페이지에 메일이 없습니다: 패널에서 그 안의 폴더가 아니라 `~/Library/Mail` 자체를 선택하세요. 패널을 다시 띄우려면 「연결 해제」한 뒤 다시 「연결」하세요
- 계정이 없습니다: 쓸 이메일이 없는 계정(예를 들어 빈 보낼 편지함)은 목록에 나오지 않습니다
- 파일에 본문이 다운로드되지 않았다고 적혀 있습니다: Mail에 헤더만 있습니다. Mail에서 그 이메일을 한 번 열면 다음 동기화에서 본문을 씁니다

## Related

- [Mail](https://exporter.dev/ko/mail): 모든 이메일을 Markdown 파일로
- [메시지](https://exporter.dev/ko/docs/messages): 대화, 미디어, 필드, 해결 방법
- [MCP 서버](https://exporter.dev/ko/docs/mcp): Claude와 다른 에이전트 연결하기

---

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