匯入既有 Markdown 筆記

從 Obsidian 遷移

如果你原本使用 Obsidian，Hyday 可以協助你把內容複製到目前的筆記資料夾，原本的 Obsidian 資料夾只會被讀取，不會被搬動、刪除或改寫；確認遷移結果之前，也可以隨時關閉流程

第一次開啟 Hyday、選好或建立筆記資料夾後，按下「從 Obsidian 遷移」即可開始，如果已經完成初始設定，請到「設定 → 筆記管理」，按下「Obsidian 遷移助手」

接著選擇 Obsidian 原本使用的資料夾，Hyday 會先掃描內容，列出找到的 Markdown、圖片、影片與其他附件，讓你確認要帶入哪些檔案

遷移前先看預覽

掃描完成後，預設會選取找到的檔案，你可以先取消不想帶入的項目，再按「查看預覽」

這裡的「預覽」不是把筆記或圖片顯示成閱讀畫面，而是先列出 Hyday 準備怎麼處理每個檔案：來源、目的地、會不會轉換，以及需要注意的地方

筆記與其他附件會放在：

imports/<來源資料夾名稱>/<原本的資料夾結構>

圖片與影片會集中放在 assets/，檔名會加上內容識別碼，避免不同檔案剛好同名，原本的資料夾不會因此被整理或改名

如果筆記裡有 Obsidian 的 ![[圖片或影片]] 嵌入，預覽時可以勾選「轉換圖片與影片嵌入」，找到對應附件時，筆記項目會顯示「查看文字變更」，可以展開比較轉換前後的 Markdown

如果找不到唯一對應的附件，畫面只會顯示提醒，不會硬猜是哪一個檔案，原本的嵌入語法會完整保留，等你確認附件位置後再自行處理

哪些內容會保留原樣？

Frontmatter 會和筆記正文一起保留，不會被刪除、補欄位或重新排列，一般文字、標籤與連結也不會因為遷移而被大幅改寫；只有你在預覽中勾選圖片與影片轉換，而且找到對應附件時，嵌入連結才會變成 Markdown 連結

Dataview、Templater、HTML／MDX、callout，以及 Obsidian 的區塊連結（例如 [[note#^block-id]]）目前不會執行或重建，這些內容會保留在原檔裡，預覽會提醒你確認；其中區塊連結不保證能在 Hyday 裡跳到原本的區塊位置

以 YYYY-MM-DD.md 或 YYYY.MM.DD.md 命名的既有日誌，也會沿用原本的資料夾結構，Hyday 不會因為辨識到日期，就自動改名、搬到另一個日誌資料夾或合併內容

遇到同名檔案怎麼辦？

Hyday 不會直接覆寫筆記資料夾裡原本的檔案，遇到目的地已經有同名檔案時，可以選擇：

• 保留目的地原檔，略過這次遷移
• 保留兩份，讓 Hyday 在預覽中使用新的檔名

內容完全相同的檔案會直接標示為已存在，不會重複建立

遷移完成後

完成後，遷移結果會列出這次建立、略過與未完成的檔案，之後可以在「設定 → 筆記管理 → 遷移紀錄」查看紀錄，必要時選擇回復這次遷移

回復只會處理這次遷移建立、而且之後沒有被修改或引用的檔案，你後來改過的檔案，或已經被其他筆記引用的檔案，Hyday 會保留下來，不會為了回復而刪除

如果你是從 Bear、Notion 或 Apple Notes 搬家，請先使用原工具或第三方工具匯出成 Markdown，再依照實際需要選擇資料夾，搬家只是第一步；先實際寫幾篇筆記、記幾天日誌，再慢慢整理內容，通常會比較安心

接著可以閱讀筆記與可攜 Markdown，了解哪些內容會保留在自己的 Markdown 檔案裡