Notion

Notion の書き出しの仕組みを、接続から問題の解決まで。

接続

Exporter のホームの「クラウド」で Notion の横にある「接続」を押します。Apple でサインインすると、ブラウザで Notion のページが開くので、Exporter に読み取りを許可するページを選んでアクセスを許可します。Exporter が Notion に求めるのは読み取りだけです。Exporter に戻ったらファイルの保存先を選び、「このフォルダを使う」を押します。

Notion のトークンは Exporter のサーバー上に封印されたままです。Mac はそのサーバーにサインインするだけで、トークンを持つことはありません。

Exporter と共有したページだけが、その下のすべてのページとデータベースとともに同期されます。あとからページを追加するには、Notion でそのページの ⋯ メニューを開き、exporter.dev の接続を追加します。次の同期で届きます。共有をやめたページは、次の 1 日 1 回の確認でフォルダからなくなります。

項目を選ぶ

選択ページには共有されたページとデータベースがすべてチェックされた状態で並び、「すべて」「ページ」「データベース」の 3 つのタブがあります。不要なもののチェックを外すと、そのファイルは書き出されません。

ファイルの置き場所

~/Documents のようにホームフォルダ直下のフォルダには、中に notion-export フォルダが作られます。それより深いフォルダはそのまま使われます。

ページ：Notion が表示するフォルダに、タイトルで名付けて置かれます：Projects/Plan Q4.md。下にページがあるページには、そのファイルの横に同じ名前のフォルダができます。
データベース：データベース名のフォルダに 1 行 1 ファイル、その横に表全体：Projects/Tasks/Write the plan.md と Projects/Tasks.csv
Notion がホストする画像とファイル：ページのフォルダの attachments/ に置かれ、ページからリンクされます

タイトルの / と : は空白になります。同じフォルダに同じタイトルのページが 2 つあるときは、先に作られたほうがそのタイトルを使い、もう一方は ID の最初の 6 文字をかっこに入れて付けます。

ファイルの中身

ページのフロントマターには title、id、created、modified、source_url、そしてそのページが属するページまたはデータベースを示す parent が入ります。データベースの行には、Notion でのプロパティ名のまま、データベースの順に、そのプロパティが加わります：テキスト、数値、日付、真偽値、名前のリスト。続いてタイトルと、ふつうの Markdown にしたページ。コールアウトはアイコン付きの引用に、トグルは details ブロックになり、色は取り除かれます。書き出した別のページへのリンクは、そのファイルへの相対リンクになります。時刻は UTC です。

データベースの CSV は、プロパティごとに 1 列、行ごとに 1 行で、古い順に並びます。

同期

Notion は編集、移動、削除のたびに Exporter のサーバーへ知らせます。サーバーがファイルを書き直して Mac に伝え、Mac がそれをダウンロードするので、変更は数分以内に届きます。Notion 自体が知らせるまでに 1、2 分待ちます。名前を変えたり移動したりしたページは、ファイルと添付ファイルも移動します。「今すぐ同期」はまずサーバーに問い合わせ、「完全再同期」はすべてのファイルを書き直します。

Exporter Cloud

最初の接続から 7 日間は無料です。その後 Exporter Cloud は App Store のサブスクリプションになります。Notion 単体か、Linear、Notion、今後追加するすべてのクラウドソースを含む All Cloud を、月額または年額で。プランが終わると同期は止まり、ファイルは残ります。30 日後、サーバーはコピーとトークンを削除します。

アカウント

「設定」›「アカウント」に、サインインしたメールアドレスが表示されます。「サインアウト」は次にサインインするときのために接続を残します。Notion の接続を解除すると、Notion での Exporter のアクセスが取り消され、exporter.dev 上の Exporter のコピーが削除されます。「アカウントを削除…」はすべてのワークスペースの接続を外し、サーバーが保管しているものをすべて削除します。Mac 上のファイルは残ります。

コマンドライン

exporter export --source notion --dest <folder> は、コマンドラインのカードで許可したフォルダにワークスペースのファイルを書き出します。コマンドラインを参照してください。

困ったとき

ページが見当たらない：Notion でそのページの ⋯ メニューから exporter.dev の接続と共有し、チェックが入っているか確かめてから「今すぐ同期」を押します。
画像がリンクで表示される：Notion が渡してくれなかったため、ファイルは代わりに Notion 上の画像へリンクしています。
カードに「もう一度接続…」と出る：Notion がその接続を受け付けなくなっています。多くは Notion の設定で接続が外されたためです。押してもう一度アクセスを許可してください。
カードに「サインイン…」と出る：セッションが終わりました。同じ Apple アカウントでサインインすれば同期が続きます。

接続

ページを共有する