# 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>` は、コマンドラインのカードで許可したフォルダにワークスペースのファイルを書き出します。[コマンドライン](https://exporter.dev/docs/cli) を参照してください。

## 困ったとき

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

## Related

- [Notion](https://exporter.dev/ja/notion): ページとデータベースをファイルに
- [Notion のガイド](https://exporter.dev/ja/guides/notion): Obsidian とバックアップ
- [価格](https://exporter.dev/ja/pricing): 無料枠、買い切り、Exporter Cloud

---

human version: https://exporter.dev/ja/docs/notion
every page: https://exporter.dev/llms.txt
