# 匯入既有 Markdown 筆記

> 把既有 Markdown 筆記帶進 Hyday，保留原始檔案並逐步確認相容性。

## 從 Obsidian 遷移

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

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

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

## 遷移前先看預覽

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

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

筆記與其他附件會放在：

```text
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](/docs/notes-and-markdown)，了解哪些內容會保留在自己的 Markdown 檔案裡。