# 캘린더

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

## 연결

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::` | 참석 인원 수 |

```markdown
## 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개 이벤트는 무료이고 계속 무료입니다. 캘린더를 잠금 해제하면 나머지도 내보내집니다([가격](https://exporter.dev/pricing)).

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

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

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

## 문제와 해결

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

## Related

- [캘린더](https://exporter.dev/ko/calendar): 한 달이 Markdown 파일 하나
- [미리 알림](https://exporter.dev/ko/docs/reminders): 목록 파일, 필드, 해결 방법
- [MCP 서버](https://exporter.dev/ko/docs/mcp): Claude와 다른 에이전트 연결하기

---

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