カレンダー

接続

Exporter のホームでカレンダーの横にある「接続」を押し、続いて「カレンダーのフォルダを開く」を押します。ウインドウはカレンダーのフォルダ ~/Library/Group Containers/group.com.apple.calendar で開くので、「このフォルダを選択」を押してください。続いてファイルの保存先を選び、「このフォルダを使う」を押します。

macOS はカレンダーのアクセス許可を求めず、Exporter も決して求めません。予定は許可されたフォルダの中のデータベースから読まれ、EventKit は使いません。ほかのアプリで見た許可ダイアログは、そちらの経路のものです。

ファイルの置き場所

1 か月につき 1 つの Markdown ファイルが 1 つのフォルダに入ります: 2026-09.md、2026-10.md。ホームフォルダの直下にあるフォルダ、たとえば ~/Documents を選ぶと、その中に calendar-export フォルダができます。もっと深いフォルダ、たとえば ~/Documents/calendar はそのまま使われます。予定のない月にファイルはできません。

書き出される範囲

カードでチェックされているカレンダーの予定すべて、設定された期間の中のもの。ピッカーはカレンダーのサイドバーと同じくアカウントごとにまとめるので、チェックを 1 つ外すだけでアカウントを除外できます。

予定は始まる月に、ちょうど 1 回だけ入ります。月末をまたいでも同じです。

繰り返し

繰り返す予定は、作られた日だけでなく、起きる日すべてに並びます。Exporter はカレンダーが自分の表示のために保持している出現を読むので、ファイルはアプリと一致し、どう繰り返すかが行に書かれます。

形式

常に Markdown です。月のフロントマター、続いて 1 日 1 見出しと予定ごとの 1 行。

1 日は終日の予定から始まり、そのあと開始時刻順に並びます。カレンダーが描く順番そのままです。終日の予定は「all day」と書かれ、無かった 00:00 を与えられることはありません。

ファイルの中身

キー	内容
title, month	「カレンダー、2026年9月」と 2026-09
events	そのファイルに入っている予定の件数
calendars	その月のカレンダー、件数の多い順

1 行は、時刻、予定、出どころのカレンダー、場所。そのあとに 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 年、すべて。書き出されるファイルが変わるので、期間を狭めれば書き出しも小さくなります。

カレンダーが自分の表示のために保持している出現はおよそ 2 年分で、読めるのはそこまでです。実機では 2 年、5 年、すべてのいずれでも同じ予定が返ります。「すべて」とはこの Mac にあるすべてであって、これまでに起きたすべてではありません。

無料と解除

最初の 100 件は無料で、そのままです。カレンダーを解除すると残りも書き出されます（価格）。

同期と全体の再同期

最初の「sync now」のあとは、月の中身が変わったときにその月だけが書き直されます。頻度は多くても 1 分に 1 回です。予定を動かすと、その予定の月だけが書き直されます。

「full resync」は先に確認してから、Exporter が書いた月ファイルを削除し、チェックされているカレンダーをすべて書き直します。フォルダ内のそれ以外のものは残ります。

困ったとき

• 「no calendar database in that folder (pick the Calendar folder itself)」: もう一度「connect」を押し、ウインドウが開いたそのフォルダを選んでください
• カレンダーが足りない: カードでチェックが外れているか、そのアカウントごと外れています。ピッカーはアカウントごとにまとめています
• 古い予定がない: 「reads」の行が短い期間になっているか、カレンダー自身がもう保持していません
• リマインダーが書き出しに混じる: カレンダーは予定表のリマインダーを独立したカレンダーとして表示します。カードで「Reminders」アカウントのチェックを外してください