Notion

連接

在 Exporter 主頁的「雲端」下，點按 Notion 旁的「連接」。使用 Apple 登入，瀏覽器會開啟 Notion 的頁面，在那裡選擇允許 Exporter 讀取的頁面並允許存取。Exporter 只要求讀取 Notion。回到 Exporter，選擇檔案存放的位置，然後點按「使用這個資料夾」。

Notion 權杖封存在 Exporter 的伺服器上。Mac 只登入該伺服器，從不持有權杖。

共享頁面

只有與 Exporter 共享的頁面會同步，連同它們下面的每個頁面和資料庫。之後要加入頁面，請在 Notion 中開啟它的 ⋯ 選單，加入 exporter.dev 連接；它會在下次同步時送達。你不再共享的頁面，會在下次每日檢查時離開你的資料夾。

選擇項目

選擇頁面列出所有已共享的頁面和資料庫，全部勾選，並有「全部」「頁面」「資料庫」三個標籤頁。取消勾選你不需要的，它的檔案就會被移除。

檔案去哪裡

直接位於個人資料夾下的資料夾（如 ~/Documents）會在其中產生一個 notion-export 資料夾。更深的資料夾按原樣使用。

• 頁面：放在 Notion 顯示它們的資料夾中，以標題命名：Projects/Plan Q4.md。下面還有頁面的頁面，會在它的檔案旁有一個同名資料夾。
• 資料庫：一個以資料庫命名的資料夾，每列一個檔案，整個表格放在它旁邊：Projects/Tasks/Write the plan.md 和 Projects/Tasks.csv
• Notion 代管的圖片和檔案：放在頁面所在資料夾的 attachments/ 中，由頁面連結

標題中的 / 和 : 會變成空格。同一資料夾中兩個頁面標題相同時，先建立的保留標題，另一個則加上其 ID 的前 6 個字元，放在括號中。

檔案內容

頁面的 front matter 包含 title、id、created、modified、source_url 和 parent，即它所在的頁面或資料庫。資料庫列會依資料庫的順序，加上它的屬性，名稱與 Notion 中相同：文字、數字、日期、真或假，以及名稱清單。接著是標題和以一般 Markdown 呈現的頁面。標註是帶圖示的引用，摺疊區塊是 details 區塊，顏色會被捨棄。指向另一個已匯出頁面的連結是指向其檔案的相對連結。時間為 UTC。

資料庫的 CSV 每個屬性一欄，每列一行，按時間由舊到新排列。

同步

Notion 把每次編輯、移動和刪除告訴 Exporter 的伺服器。伺服器重寫檔案並通知 Mac，Mac 再下載，所以修改幾分鐘內送達；Notion 自己通知之前也要等一兩分鐘。改名或移動的頁面會連同它的檔案和附件一起移動。「立即同步」會先詢問伺服器，「完全重新同步」會重寫每個檔案。

Exporter Cloud

從第一次連接起 7 天免費。之後 Exporter Cloud 是 App Store 中的訂閱：單獨的 Notion，或包含 Linear、Notion 以及我們日後加入的所有雲端來源的 All Cloud，按月或按年。方案結束時同步停止，檔案保留。30 天後伺服器刪除副本和權杖。

帳號

「設定」›「帳號」顯示你登入所用的電子郵件。「登出」會保留連接以便下次登入。中斷 Notion 的連接會在 Notion 中撤銷 Exporter 的存取權限，並刪除 Exporter 在 exporter.dev 上的副本。「刪除帳號…」會中斷所有工作空間，並刪除伺服器保存的一切。Mac 上的檔案保留。

命令列

exporter export --source notion --dest <folder> 會把工作空間的檔案寫入你在命令列卡片中允許的資料夾。參見命令列。

問題與排查

• 缺少頁面：在 Notion 中透過它的 ⋯ 選單與 exporter.dev 連接共享它，確認它已勾選，然後點按「立即同步」。
• 圖片顯示為連結：Notion 沒有交出它，所以檔案改為連結到 Notion 中的那張圖片。
• 卡片顯示「重新連線…」：Notion 不再接受該連接，通常是因為它已在 Notion 設定中被移除。點按它再次允許存取。
• 卡片顯示「登入…」：工作階段已結束。用同一個 Apple 帳號登入，同步會繼續。