캘린더

연결

Exporter 홈에서 캘린더 옆의 「연결」을 누른 다음 「캘린더 폴더 열기」를 누릅니다. 창은 캘린더 폴더 ~/Library/Group Containers/group.com.apple.calendar에서 열립니다. 「이 폴더 선택」을 누르세요. 그다음 파일이 저장될 위치를 고르고 「이 폴더 사용」을 누릅니다.

macOS는 캘린더 접근 권한을 묻지 않고, Exporter도 절대 묻지 않습니다. 이벤트는 허용한 폴더 안의 데이터베이스에서 읽으며 EventKit을 쓰지 않습니다. 다른 앱에서 본 권한 대화상자는 그 다른 경로의 것입니다.

파일이 가는 곳

한 달에 Markdown 파일 하나가 폴더 하나에 들어갑니다: 2026-09.md, 2026-10.md. 홈 폴더 바로 아래의 폴더, 예를 들어 ~/Documents를 고르면 그 안에 calendar-export 폴더가 생기고, 더 깊은 폴더, 예를 들어 ~/Documents/calendar는 그대로 쓰입니다. 이벤트가 없는 달은 파일이 생기지 않습니다.

무엇이 내보내지는가

카드에서 체크된 캘린더의 모든 이벤트, 설정된 기간 안에서. 선택기는 캘린더 사이드바처럼 캘린더를 계정별로 묶으므로 체크 하나로 계정을 뺄 수 있습니다.

이벤트는 시작하는 달에 정확히 한 번 들어갑니다. 달 끝을 넘겨 이어져도 마찬가지입니다.

반복

반복 이벤트는 만들어진 날만이 아니라 일어나는 모든 날에 들어갑니다. Exporter는 캘린더가 자신의 화면을 위해 보관하는 발생을 읽으므로 파일이 앱과 일치하고, 어떻게 반복되는지가 줄에 적힙니다.

형식

언제나 Markdown입니다. 달의 프런트매터, 그다음 하루에 제목 하나와 이벤트마다 한 줄.

하루는 종일 이벤트로 시작해 시작 시간순으로 이어집니다. 캘린더가 그리는 순서 그대로입니다. 종일 이벤트는 「all day」라고 적고, 없던 00:00을 절대 얻지 않습니다.

파일

키	담는 것
title, month	「캘린더, 2026년 9월」과 2026-09
events	파일에 담긴 이벤트 수
calendars	그달의 캘린더, 가장 많은 것부터

한 줄은 시간, 이벤트, 온 캘린더, 장소이고, 그다음 vault가 질의할 수 있는 필드가 옵니다.

필드	담는 것
repeats::	daily, weekly, every 2 weeks
join::	이벤트에 있을 때 화상 통화 링크
with::	참석 인원 수

## 2026-09-17, 목요일

- all day 매릴린 생일 · 생일
- 09:30-10:00 스탠드업 · 업무 · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 케빈과 점심 · 개인 · Philz Coffee

얼마나 거슬러 읽는가

카드의 「reads」 줄: 올해, 2년, 5년, 전체. 어떤 파일이 쓰이는지를 바꾸므로 기간이 좁을수록 내보내기도 작아집니다.

캘린더는 자신의 화면을 위해 두 해 정도의 발생을 보관하며 읽을 수 있는 것도 거기까지입니다. 실제 Mac에서 2년, 5년, 전체는 같은 이벤트를 돌려줍니다. 「전체」는 이 Mac에 있는 전부이지, 여태 일어난 모든 것이 아닙니다.

무료와 잠금 해제

처음 100개 이벤트는 무료이고 계속 무료입니다. 캘린더를 잠금 해제하면 나머지도 내보내집니다(가격).

동기화와 전체 재동기화

첫 「sync now」 이후에는 달 안에서 무언가 바뀔 때 그 달을 다시 씁니다. 많아야 1분에 한 번입니다. 이벤트를 옮기면 그 이벤트의 달만 다시 씁니다.

「full resync」는 먼저 확인한 뒤, Exporter가 쓴 월 파일을 지우고 체크된 캘린더를 모두 다시 씁니다. 폴더의 나머지는 그대로 남습니다.

문제와 해결

• 「no calendar database in that folder (pick the Calendar folder itself)」: 「connect」를 다시 누르고 창이 열린 그 폴더를 선택하세요
• 캘린더가 빠졌습니다: 카드에서 체크가 풀렸거나 계정 전체가 풀렸습니다. 선택기는 캘린더를 계정별로 묶습니다
• 오래된 이벤트가 없습니다: 「reads」 줄이 짧은 기간에 있거나, 캘린더 자체가 더는 갖고 있지 않습니다
• 미리 알림이 내보내기에 섞입니다: 캘린더는 일정이 잡힌 미리 알림을 별도 캘린더로 보여줍니다. 카드에서 「Reminders」 계정의 체크를 푸세요