如何把 Obsidian 庫匯入 Flexnote

真正讓人遲遲不換筆記工具的，通常不是新工具學不會，而是舊庫搬不動。 一個用了幾年的 Obsidian Vault 裡，除了 Markdown 檔案，還有目錄、標籤、雙鏈、圖片、PDF， 以及花了不少時間排好的 Canvas。讓人把這些全部丟下，從空白頁重新開始，不現實。

Flexnote 現在可以直接讀取本機 Obsidian 庫。你可以選擇整個 Vault，也可以只遷移幾個一級目錄； Markdown 筆記會進入卡片庫，原目錄會出現在側欄的「Ob匯入」收藏樹中。 如果開啟 Canvas 匯入，白板上的文本、筆記、分組、附件和連線也會一起轉換。

哪些內容可以匯入？

這次匯入並不是簡單地把 Markdown 正文複製一遍。Flexnote 會先掃描 Vault，再按內容型別做轉換。 當前支援的主要內容如下：

匯入前，先知道幾個轉換規則

目錄會保留，但它承擔的是導航作用

假設 Vault 裡有「研究 / 論文 A / 文獻筆記」這樣的目錄。匯入後，側欄會建立 「Ob匯入 / 研究 / 論文 A / 文獻筆記」收藏層級，並把對應卡片放進去。 卡片本身仍然存在於 Flexnote 卡片庫中，收藏樹負責保留你熟悉的入口。

標籤會進入 Flexnote 標籤體系

如果筆記的 YAML Properties 中填寫了 tags，匯入時優先使用這些標籤；沒有 Properties tags 時，再讀取正文裡的 #標籤。已經轉成標籤的正文標記會被清理，避免同一個標籤既掛在卡片上， 又以普通文字重複留在正文中。

雙鏈會盡量繼續指向原來的筆記

[[筆記名]]、帶路徑的雙鏈和 [[筆記名|顯示別名]]會在匯入時匹配本批次筆記。匹配成功後，它們會變成可以直接開啟對應卡片的連結。 找不到目標的連結不會被隨手刪掉，而會保留標題，方便之後繼續查詢和補全。

Obsidian 特有語法會做相容處理

Callout 會保留為帶圖示的引用塊；Obsidian 註釋會被移除；腳註、任務列表、高亮、上下標和 details 摺疊內容會轉換為 Flexnote 編輯器可以識別的形式。複雜主題樣式、外掛生成的自定義語法， 以及除 tags 之外的 Properties 不保證一比一還原，遷移後建議抽查幾篇結構最複雜的筆記。

如何匯入 Obsidian Vault

第一步：開啟匯入入口，選擇 Obsidian 庫

在 Flexnote 左側邊欄開啟收藏區域，然後進入匯入視窗，選擇「Obsidian 庫」。 桌面端會嘗試列出這臺電腦上已經註冊的 Vault，最近開啟的庫會排在前面。 如果目標庫沒有出現，也可以點選「選擇其他目錄」，手動定位到 Vault 根目錄。

第二步：選擇要遷移的目錄

Flexnote 會統計 Vault 根目錄和各個一級目錄中的筆記、Canvas 數量。你可以全選，也可以只勾選 「正在進行的專案」「課程筆記」之類仍在使用的目錄。這樣很適合分批遷移：先搬高頻內容， 檢查排版和連結，再處理歸檔資料。

「匯入 Canvas 畫布」預設開啟。如果這次只想遷移 Markdown，可以把它關掉；Canvas 檔案仍會留在原 Vault 中，之後可以重新選擇同一個目錄再匯入。

第三步：開始匯入並檢查「Ob匯入」收藏樹

匯入過程中會顯示當前檔案和整體進度。完成後，側欄會出現「Ob匯入」資料夾；展開它， 就能看到按原目錄排列的筆記與白板。匯入結果還會分別統計新建筆記、更新筆記、新建畫布、 更新畫布、跳過項和補充的收藏入口。

Canvas 匯入後會變成什麼？

Obsidian Canvas 與 Flexnote 白板的結構並不完全相同，所以這裡做的是型別轉換，而不是把 JSON 原樣塞進新白板。Flexnote 會盡量保留節點位置、尺寸、顏色、分組關係和連線方向。

• 文本節點轉成白板文本，節點內 Markdown 會繼續轉換；
• 指向 Markdown 的檔案節點會引用已經匯入的筆記卡片；
• 圖片、影片和音訊轉成媒體卡片，PDF 轉成 PDF 卡片；
• 其他附件轉成檔案節點，網頁連結轉成網頁卡片；
• Group 轉成白板分組，並根據空間位置恢復內部節點；
• Edges 轉成連線，保留標籤、顏色、連線方向和箭頭樣式。

如果 Canvas 引用了一個找不到的檔案，Flexnote 會用文本節點標出原檔名，而不是讓該位置直接消失。 這能幫助你在遷移後發現缺失附件。由於兩套畫布的渲染模型不同，複雜巢狀分組、特殊顏色或外掛擴充套件節點 仍可能需要手動調整。

第二次匯入同一個庫，會不會產生重複筆記？

預設不會。Flexnote 會記錄每篇匯入筆記和每張 Canvas 在 Vault 內的相對路徑。 再次掃描同一路徑時，會把它識別為已經匯入的內容，並讓你選擇處理方式：

• 跳過已存在：保留 Flexnote 中已經編輯過的版本，只匯入 Vault 裡新增的檔案。 這是預設選項，也最適合日常增量遷移。
• 覆蓋已存在：用 Obsidian 當前內容更新原筆記；Canvas 會保留原白板入口， 清空內部節點後重新構建。請先確認 Flexnote 裡沒有隻存在於本地版本的重要修改。
• 僅補充收藏：不建立或修改筆記、白板，只把缺失的收藏入口補回側欄。

一套更穩妥的遷移順序

如果你的 Vault 已經用了幾年，不必追求一次完成。下面這套順序更容易檢查問題：

1. 先備份 Obsidian Vault 和 Flexnote 資料；
2. 選擇一個同時包含標籤、雙鏈、圖片和 Canvas 的小目錄；
3. 匯入後檢查目錄、幾篇複雜筆記，以及一張節點較多的 Canvas；
4. 確認結果後，再匯入其餘目錄；
5. 後續增量匯入先用「跳過已存在」，確實需要同步原始檔修改時再選擇「覆蓋」。

匯入解決的是搬家成本，不要求你立刻放棄原來的工作習慣。你可以先把 Obsidian 當作熟悉的寫作環境， 把需要視覺整理的專案帶到 Flexnote；也可以完整遷移後，用卡片庫搜尋資料，再把關鍵筆記放上白板重組。 先拿一小塊真實資料試一遍，通常比看十篇功能對比更容易判斷這套工作流是否適合你。