Obsidian : 用 Markdown 連結插入附圖，並讓附件跟著筆記搬移.
用 Obsidian 寫筆記一陣子後，我遇到兩個很煩的問題：貼上的截圖全擠在同一個資料夾，檔名是一串看不懂的數字；而且筆記一搬家，圖片就破了。更糟的是，Obsidian 預設插入的是 ![[圖片.png]] 這種 Wiki 格式，把筆記放到 GitHub 或其
他 Markdown 編輯器上，圖片完全顯示不出來。
花了一個晚上反覆測試後，我終於調出一套穩定的設定。這篇把整個過程和踩過的坑整理出來，希望幫忙少走一點冤枉路。
📌 這篇會做到的效果
- 貼上圖片時，插入標準 Markdown 連結：
 - 每則筆記的圖片放在自己的資料夾：
assets/筆記名稱/ - 筆記搬移或改名時，圖片跟著搬，連結也自動更新、維持完整路徑
需要準備的東西
除了 Obsidian 本身，還要安裝兩個社群外掛。它們分工很清楚：
| 外掛 | 負責什麼 |
|---|---|
| Custom Attachment Location | 決定附件存在哪裡、檔名怎麼取 |
| Advanced Rename and Delete Handler | 筆記搬移或改名時，讓附件跟著搬、更新連結 |
⚠️ 第一個坑：Custom Attachment Location 從 12.0.0 版開始，把「搬移時附件跟著走」這部分交給 Advanced Rename and Delete Handler 處理。沒裝後者的話，前者根本不會啟用。好消息是，它的設定頁會提示你，按一下就能安裝。
步驟一：關掉 使用 [[Wikilinks]]，改用 Markdown 連結
這是 Obsidian 內建的設定，不用外掛。打開「設定 → 檔案與連結」（Settings → Files and links），把「使用 [[Wikilinks]]」關掉。
之後拖曳或貼上圖片，就會插入 ，不再是 ![[圖片.png]]。
💡 以前已經插入的 Wiki 格式連結不會自動轉換，需要手動改。
步驟二：內部連結格式改成「相對路徑」
在同一個設定頁，把「內部連結格式」 設成「插入對應目前檔案的相對路徑」
⚠️ 第二個坑，也是我卡最久的地方：
貼上圖片時連結明明是對的：
但搬移筆記後，圖片檔案搬對了、資料夾也建對了，連結卻被改成只剩檔名：
原因是 內部連接格式 設成了「以儘可能簡短的形式插入」。搬移時外掛會照這個設定重寫連結，只要整個 vault 裡沒有同名檔案，最短寫法就是只留檔名。Obsidian 裡還看得到圖，但換到 GitHub 或其他編輯器就破圖了。改成相對路徑就解決了。
步驟三：安裝並打開 Advanced Rename and Delete Handler
也可直接先走第四步 - 安裝 Custom Attachment Location，如上所述，從 12.0.0 版開始，Custom Attachment Location 要搭配 Advanced Rename and Delete Handler 才會啟用，在它的設定頁按一下就能安裝。
這個外掛裝好後預設什麼都不做，一定要自己打開「筆記改名或搬移時，一起處理附件和更新連結」的選項，附件才會跟著走。
它也有「刪除筆記時一併刪除附件」的選項。這個比較危險，萬一有圖片被多則筆記共用，可能會誤刪，建議熟悉之後再考慮開。
步驟四：設定每則筆記一個附件資料夾
安裝 Custom Attachment Location 之後，Obsidian 內建的「新附件的預設位置」會顯示由外掛接管。(顯示 Open)
外掛有個「沿用 Obsidian 附件位置」(Follow Obsidian attachment location) 的選項，新安裝時預設是開的。把它關掉，再把附件位置填成：
./assets/{{noteFileName}}這樣每則筆記的圖片都會放在「筆記所在資料夾 / assets / 筆記名稱」底下。
為什麼不全部共用一個 assets 資料夾？共用時，搬移一則筆記，它的圖片會被搬到新位置；如果某張圖同時被別的筆記引用，那則筆記就破圖了。每則筆記一個資料夾，彼此不會互相影響。
步驟五：Markdown URL 格式
Custom Attachment Location 的 Advanced 設定裡有一個「Markdown URL 格式」欄位。它只管連結路徑「怎麼寫」，不影響圖片存在哪裡。初始值是空白 ，連結會照 Obsidian 的新連結格式產生。
當想要特殊寫法時需要填寫，例如目前這個有使用 assets/[筆記名稱] 為資料夾的情況：
驗收：實際搬一次看看
- 新建一則測試筆記，貼一張截圖。
- 確認連結長得像
。 - 把筆記拖到另一個資料夾。
- 確認圖片搬到新資料夾的
assets/測試筆記/，而且連結仍是完整路徑，不是>只剩檔名。
舊筆記的圖片，可以用命令面板執行 Custom Attachment Location 的「Collect attachments」，依新規則整理到正確位置，單則筆記、單一資料夾或整個 vault 都可以。建議先拿一個小資料夾試，確認沒問題再整理全部。
設定總整理
| 位置 | 設定 |
|---|---|
| Obsidian：使用 [[Wikilinks]] | 關閉 |
| Obsidian：內部連結格式 | 插入對應目前檔案的相對路徑 |
| Advanced Rename and Delete Handler | 打開改名、搬移時處理附件與連結；刪除選項先不開 |
| Custom Attachment Location：沿用 Obsidian 附件位置 | 關閉 |
| Custom Attachment Location：附件位置 | ./assets/{{noteFileName}} |
| Custom Attachment Location：Markdown URL 格式 | assets/{{noteFileName}}/{{generatedAttachmentFileName}} |
什麼情況其實不用裝外掛？
如果你只是想用 Markdown 連結插入圖片，不需要每則筆記一個資料夾，也不在意搬移時附件跟著走，那只要做步驟一和步驟二，再用 Obsidian 內建的「新附件的 預設位置」指定資料夾就夠了。兩個外掛的價值在於更細的控制：依筆記名稱自動建資料夾、自訂檔名規則，以及搬移改名時自動整理。
結語
這套設定最關鍵的其實不是外掛，而是那個不起眼的「內部連結格式」。外掛負責搬檔案，但連結怎麼寫，最後還是聽 Obsidian 的。把它設成完整的相對路徑之後，我的筆記不管在 Obsidian、GitHub 還是其他編輯器裡打開，圖片都能正常顯示。
外掛各選項的名稱可能隨版本調整，請以你畫面上看到的為準。更多細節可以參考 Custom Attachment Location 的 GitHub 說明，裡面還附了一個示範 vault，可以邊看邊試。
如果你也有自己的 Obsidian 附件整理方式，歡迎在留言分享 🙌
留言
張貼留言