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>는 「명령줄」 카드에서 허용한 폴더에 이메일을 쓰고, 카드 자체의 동기화는 건드리지 않습니다. 명령줄을 참고하세요.

문제와 해결

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