移動資料夾後仍保持 Markdown 日記圖片正常顯示的方法
為了在移動 Markdown 日記時避免本地相片失效，請將圖片存放在日記資料夾內，並從引用該圖片的筆記使用相對路徑進行連結。接著在保留其內部階層結構的情況下移動或複製整個資料夾，在平時使用的 Markdown 檢視器中打開移動後的筆記，並確認範例圖片是否能正常顯示。在某個編輯器中可以正常運作的路徑，並不代表所有檢視器都會以相同方式解析它。
圖片相對路徑的意義
Markdown 的圖片語法包含驚嘆號、方括號內的替代文字（alt text），以及圓括號內的圖片目的地。例如， 透過描述圖片相對於 Markdown 檔案的位置來指向該圖片。CommonMark 規範展示了像 train.jpg 這樣的圖片目的地，Markdown 指南（Markdown Guide）也記載了相同的基本語法。CommonMark: Images Markdown Guide: Basic Syntax
相對路徑在移動日記時非常實用，因為它描述的是檔案之間的關聯，而不是指明某台電腦上的特定位置。如果筆記和圖片一起移動且沒有改變這層關聯，該路徑仍然會指向同一張圖片。像 /Users/sam/Pictures/blue-mug.jpg 或 C:\\Users\\Sam\\Pictures\\blue-mug.jpg 這樣的絕對路徑指定的是特定機器上的位置；將日記複製到不同的磁碟機或電腦可能會導致該路徑失效。
選擇便於一同遷移的資料夾結構
對於按年份組織筆記的日記，一種實用的結構是在年份資料夾旁放置一個共用的圖片資料夾：
text Diary/ ├── images/ │ ├── blue-mug.jpg │ └── garden-bed.png ├── 2025/ │ └── 2025-04-12.md └── 2026/ └── 2026-09-30.md
從 Diary/2026/2026-09-30.md 出發，指向 blue-mug.jpg 的路徑是 ../images/blue-mug.jpg：從 2026 往上一層目錄，然後進入 images。Markdown 語法可以寫作：
md 
如果每年的圖片僅屬於該年份，在同級建立子資料夾也很容易理解：
text Diary/ ├── 2026/ │ ├── images/ │ │ └── garden-bed.png │ └── 2026-09-30.md
這樣筆記就可以使用 。這些範例取決於顯示筆記所在的位置。請計算筆記與圖片之間的目錄層級；不要憑空猜測 ../ 的數量。
從筆記的角度編寫連結
請從 Markdown 檔案所在的資料夾開始，然後沿著目錄樹走向圖片。僅有檔名的目的地（例如 photo.jpg）表示圖片與筆記位於同一目錄。images/photo.jpg 表示它位於筆記旁的 images 子資料夾中。../images/photo.jpg 則表示先往上一層。這個規則提供了一種在檢視器中嘗試之前精確計算連結的方法。
在可行的情況下盡量保持名稱簡潔：例如 2026-09-30-garden.jpg。在許多檔案系統中，精確的拼寫和大寫非常重要，拼寫錯誤或大小寫不符就足以導致圖片無法顯示。Markdown 應用程式對空格和標點符號的處理方式也可能有所不同。Markdown 指南指出，應用程式對 URL 中的空格處理方式各不相同，並建議使用 %20 以確保相容性。如果圖片名稱包含空格，使用簡單的檔名可以避免這種不確定性；否則，請使用檢視器支援的編碼或引用樣式，並在那裡進行驗證。Markdown Guide: Link Best Practices
在不改變內部結構的情況下移動日記
請將日記資料夾視為一個整體。複製或移動包含 .md 筆記和圖片的 Diary/ 總資料夾，而不要只移動筆記或遺漏圖片。相對路徑在資料夾外部位置發生變更時依然有效，因為它們內部的起點和目的地之間的相對關係保持不變。
重新整理日記內部的資料夾時，需要為受影響的筆記重新計算連結。例如，將筆記從 Diary/2026/ 移動到 Diary/2026/trips/ 會改變它訪問 Diary/images/ 所需的路徑：現在需要寫成 ../../images/blue-mug.jpg。相對連結可以應對整個目錄樹的遷移，但無法自動因應僅重組目錄樹其中一部分的情況。
在常用的檢視器中進行實際移動測試
在確定依賴新的資料夾排列之前，請先進行小規模、可逆的檢查：
挑選一篇至少包含一張本地圖片的筆記，並確認該圖片目前能在平常使用的 Markdown 檢視器中正常顯示。
將完整的日記資料夾複製到另一個位置，例如另一個普通資料夾或可卸除式磁碟機。保留所有子資料夾和檔名。
在同一個檢視器中從新位置打開複製的筆記。確認圖片有顯示出來，而不僅僅是 Markdown 原始碼包含預期的文字。
打開位於不同目錄深度的筆記中的一兩張圖片，特別是任何使用了 ../ 的筆記。這能測試除了同資料夾以外的更多情況。
如果圖片遺失，請將目的地路徑與實際的資料夾結構進行比對：檢查起始筆記資料夾、每個 ../、每個子資料夾名稱、檔名拼寫、副檔名以及大小寫。修正路徑後，在移動後的複本上重複進行檢查。
這是一項實用測試，並非跨應用程式的通用保證。標準 Markdown 規範了圖片語法，但檢視器可以添加自己的慣例。例如，Obsidian 記載了 Markdown 圖片語法及其自有的嵌入語法（![[image.jpg]]），並且其設定分別說明了相對路徑、儲存庫根目錄路徑和最短路徑連結格式。如果您的日記是在基於儲存庫（vault）的應用程式中打開，請檢查您使用的是標準 Markdown 目的地還是應用程式專屬的嵌入和連結設定。Obsidian Help: Embed files Obsidian Help: Settings
排查移動後圖片損壞的問題
如果圖片消失，首先請確認檢視器打開的是哪一份筆記複本。很容易在檢查原始筆記時誤以為顯示的是移動後的筆記。然後從該筆記的目錄手動跟隨相對路徑，確認指定的圖片是否存在於目的地。
快速縮小問題範圍的方法是暫時將路徑與資料夾結構進行比對：如果 2026-09-30.md 位於 Diary/2026/，../images/blue-mug.jpg 應該解析為 Diary/images/blue-mug.jpg。如果路徑能到達目標資料夾，但檔案名稱為 Blue-Mug.JPG，請更新檔名引用或檔案名稱，使它們完全一致。如果圖片可以在檔案瀏覽器中打開，但在筆記中無法算繪，剩下的問題可能是該檢視器處理本地 Markdown 路徑的方式；請查閱其說明文件或測試純 Markdown 圖片目的地。
簡單的可移植性規則
將本地日記圖片保存在日記的最上層資料夾中，相對於顯示圖片的筆記編寫每個圖片路徑，並在移動日記時保留資料夾結構。最後，在實際的檢視器中打開移動後的複本，確認具代表性的圖片能正常顯示。這種常規檢查同時驗證了檔案關聯與應用程式的運作行為，這正是讓具可移植性的配置在日常使用中穩定可靠的關鍵。