從 Confluence 匯入
將您的 Confluence 資料直接匯入 Notion 📥
將所有資料集中在同一個地方非常重要。這是一份將 Confluence 空間匯入 Notion 的實用教學。根據您的需求，有兩種方式可以將 Confluence 資料匯入 Notion。
Zip 檔匯入工具： 可用於僅匯入工作空間的部分內容。僅能匯入 5GB（或經申請後 15GB）以下的小型工作空間。
API 匯入工具： 僅能匯入整個工作空間。可匯入 30GB 以下的工作空間。保留留言與使用者對應。
多空間匯入： 可直接透過使用者介面一次匯入最多 10 個 Confluence 空間。每個選取的 Confluence 空間都會產生專屬的記錄檔，並作為獨立的頂層私人頁面匯入（可視需要匯入至不同的 Notion 團隊協作區）。此功能僅適用於商業版與企業版方案。
✅ 匯入 | ❌ 不匯入 |
|---|---|
頁面（每次匯入最多 5 萬個頁面） | 權限（匯入的頁面會預設為匯入者的私人頁面） |
頁面階層 | 大多數巨集/外掛程式（許多巨集會轉換為純文字、圖片或連結） |
基本格式設定 | 表格樣式 |
內容區塊 | 私人頁面 |
圖片 | 自訂表情符號 |
附件 | 圖表 |
基本中繼資料（僅限頁面標題） | 預覽 |
簡易表格（複雜的結構可能會跑版） | 歷史 |
雲端與伺服器/資料中心執行個體 | 資料夾 |
留言（僅限 API 匯入） | 留言（僅限 ZIP 匯入） |
Confluence 網站 → Notion 組織
Confluence 空間 → Notion 工作空間
Confluence 頁面 → Notion 頁面
巨集 → 扁平化內容或最接近的 Notion 區塊類型（例如：Confluence Expand → Notion 摺疊）
匯入最多 ~50k 頁面 或 30GB 的資料。較大的匯入可能會失敗。
提示：針對大型工作空間，請依子工作空間或區段分割匯出，並使用 ZIP 匯入工具。若工作空間大小超過 100GB，請聯絡您的客戶經理。
匯入開始後，您可以安心關閉瀏覽器 — 我們會在完成時寄送電子郵件通知您。
您可以在
設定→匯入中查看匯入進度。您可以在該處查看匯入狀態以及已完成的匯入項目。
使用 .zip 檔案匯入
將您的 Confluence 空間匯出為 HTML
從您的 Confluence 工作空間，前往右上角側邊欄的
空間設定。在上方工具列選擇
內容工具，然後選擇匯出。若您沒看到這些選項，可能需要向工作空間管理員請求匯出權限。從格式清單中選擇
HTML。選擇
自訂匯出並取消勾選包含留言方塊。選擇您要匯出的頁面。請注意，包含大型附件的頁面可能會大幅增加匯出檔案的大小與複雜度。
請等待匯出處理完成。對於大型工作空間，這可能需要一些時間。
完成後，點擊
下載將匯出檔案儲存至您的電腦。檔案名稱將類似於Confluence-space-export-XXXXXX.html.zip。
匯入至 Notion
前往您想要匯入 Confluence 內容的 Notion 工作空間。
前往側邊欄的
設定→匯入→第三方匯入→Confluence。瀏覽並選取從 Confluence 匯出的
.zip檔案以進行上傳。您不需要解壓縮檔案，請直接上傳整個封存檔。當瀏覽器上傳檔案時，您會看到「正在上傳...」訊息，隨後匯入進度會顯示狀態訊息。
匯入完成後，系統會將您帶往新匯入的內容。
使用 Confluence API 匯入
連結 Confluence 與 Notion
前往側邊欄的
設定→匯入→Confluence。選擇
透過 API 匯入。選擇您的 Confluence 執行個體類型：雲端 (cloud) 或伺服器 (server)。若要查詢您的執行個體類型，請開啟 Confluence，點擊個人檔案旁的
說明→?→關於 Confluence。Notion 僅支援雲端與伺服器執行個體。
使用 Confluence Cloud 進行驗證
輸入您的 Confluence 電子郵件與網站。
從您的 Atlassian 帳號建立 API 權杖並輸入至欄位中。深入了解關於在 Confluence 中建立權杖的資訊。
點擊
驗證。
使用 Confluence Server 進行驗證
尋找並選擇您的 Confluence 版本。
輸入您的 Confluence 電子郵件與網站。
如果您使用的是 Confluence 7.9 或更新版本，請建立一個
個人存取權杖並貼上。如果您使用的是舊版本，請輸入您的 Confluence 使用者名稱和密碼。點擊
驗證。
匯入
從「匯入」選單中點擊
Confluence。監控匯入進度 — 對於大型工作空間，此步驟可能需要數小時。
一旦看到
正在匯入頁面…，您就可以安全地關閉瀏覽器視窗。匯入完成後，我們會寄送電子郵件通知您。
如果您想匯入多個 Confluence 空間，請重複此章節。
Notion 會將所有內容匯入到私人區段中的單一根目錄/父層級，或是匯入到執行匯入者所選的團隊協作區中。
使用者應在邀請他人之前，先整理並設定工作空間架構。
權限必須在 Notion 中重新套用 — 請規劃匯入後的作業，將 Confluence 群組和限制對應到 Notion 群組、團隊協作區和頁面層級權限。
如果 Confluence 表格中有檔案或附件，它會變成 Notion 資料庫；否則會變成簡易表格。
表格樣式和巨集/外掛程式通常會降級（例如：ui-steps、標註、圖片說明）。
大多數巨集不受支援。Notion 會嘗試將資料對應到最接近的 Notion 區塊。
由於 Confluence API 不穩定而導致的暫時性失敗，可能會使整體匯入或特定頁面失敗。您可能需要重新執行整個匯入作業。
若有多個空間，請依序執行匯入（一次一個空間），除非使用多空間匯入功能（僅限商業/企業版）。
複雜的 Confluence 資料（例如：合併儲存格、表格內嵌表格）可能會導致匯入失敗。
Notion 僅支援使用者範圍的 API 權杖（不支援範圍受限的權杖）。驗證時請使用個人 API 權杖選項。
頁面上未引用的附件和媒體將不會被匯入。
階層有時無法完全保留 — 請透過試行匯入進行驗證。
LaTeX 數學區塊匯入不正確
為什麼會發生這種情況： Confluence LaTeX 外掛程式的區塊巨集格式與行內數學不同。Notion 支援行內 LaTeX 巨集，但不支援區塊巨集變體。
修正方式：在重新匯入前，將 Confluence 中的 LaTeX 區塊巨集轉換為行內巨集，或將 LaTeX 置於程式碼區塊中，並在匯入後手動轉換為數學區塊。
無法匯入 Gliffy 內容
發生原因：Notion 的檔案匯入工具不支援 Gliffy 圖片。
修正方式：修改 HTML，在匯入前將 Gliffy 區塊替換為參照正確檔案的圖片區塊。
匯入失敗
發生原因：空間過大、匯出格式錯誤、速率限制或逾時。
修正方式：一次匯入一個空間、將大型空間拆分為多個部分、重新匯出乾淨的 ZIP 檔，或使用具備範圍執行功能的 API 匯入工具。
匯入遺失圖片或附件
發生原因：資產可能未包含在匯出檔中，或 API 權杖無法存取。
修正方式：確保匯出時已選取「包含附件」，保持 ZIP 檔中的相對路徑完整，或在匯入後重新上傳關鍵資產。
匯入後 Jira 連結預覽失效
發生原因：Jira 連結預覽僅在使用者於開始遷移前完成驗證時才能運作。
修正方式：在執行遷移前先驗證 Jira 身分。
檔案階層未如預期般保留
發生原因：匯出結構中的邊緣案例或過深嵌套。
修正方式：先使用具代表性的子集進行測試；匯入後再於 Notion 中重新整理。
Confluence 巨集及/或特殊格式遺失：
發生原因：不支援的巨集或應用程式內容。
修正方式：對應至 Notion 原生區塊：展開 → 摺疊；切換，行動項目 → 待辦清單。簡化複雜表格，或匯出為 CSV 再匯入至 Notion 資料庫。
Confluence 權限未在 Notion 中複製：
發生原因：這是自助匯入的預期行為。
修正方式：在內容匯入 Notion 後，請使用 Notion 群組、團隊協作區和頁面層級權限來規劃並執行權限對應。
