Markdown 檔案可以引用圖片,但圖片本身的資料並不在檔案裡。因此,只複製這個文字檔,文件讀起來可能很順,原本該有圖表的地方卻是一片空白。
PDF Craft 會把 Markdown 轉換結果打包成 ZIP 壓縮檔供你下載。編輯或搬移 Markdown 文件之前,請先把整個壓縮檔解開;只在壓縮檔內預覽,會看不出文件與附帶圖片之間的關聯。
確認文件與它依賴的資源
從已完成的 PDF 轉 Markdown 任務 下載 ZIP 檔,解壓縮到一個專屬資料夾。壓縮檔裡會有 Markdown 文件,若轉換過程產生了圖片資源,也會有對應的資料夾。匯出時的命名不一定相同:文件可能沿用來源檔名,也可能叫 document.md 之類的名稱;資源則可能放在 images/ 或 assets/ 底下。請用文字編輯器開啟 .md 檔,依照檔案裡實際的連結去找檔案,不要為了配合範例而把資料夾改名。原始 ZIP 檔請留著,當作未經更動的備份。
連結可能指向相對路徑的檔案、本機的絕對路徑,或遠端網址,這幾種形式的可攜性各不相同。相對路徑的檔案必須連同旁邊的資源一起保留;遠端網址則需要網路連線,而且該位址必須持續有效。
另外請確認圖說和圖號是文件裡的文字,還是圖片的一部分。保留了圖片,並不代表圖片裡的每個字都已被辨識或翻譯。這些內容之間的關係,圖片與圖說檢查指南 有更詳細的說明。
從 Markdown 檔案所在位置解讀相對路徑
關鍵在於 Markdown 檔案和它的資源資料夾之間的相對位置。以下用示意用的檔名與圖片名稱做個簡化範例;實際名稱請以你下載的內容為準:
paper/
├── notes.md
└── images/
└── figure-1.png
對應的 Markdown 可能長這樣:

編輯器會以 notes.md 所在的位置為基準,去找 images/figure-1.png。只要把整個 paper 資料夾一起搬移,這個相對關係就能維持不變。如果只搬 notes.md,圖片就不在連結所預期的位置了。
在不同系統上,檔名大小寫、空格、副檔名和特殊字元的編碼都可能造成影響。在一台電腦上看得到圖片,換到另一台卻打不開,往往是因為實際檔名和連結裡寫的名稱不一致。
搬移整個工作資料夾
原始下載的內容請保持原樣。先建立一份工作用的副本,裡面包含 Markdown 檔和它用到的所有本機資源,並先維持原本的結構。等確認原本的排列方式能正常開啟後,再重新整理。
如果要重新命名資源資料夾,記得同步更新對應的連結,並實際測試幾張圖片。多份文件若都有 image1.png 這類通用檔名,不要直接丟進同一個資料夾,否則可能互相覆蓋或混淆。
匯入筆記軟體時,請確認它是把附件複製過去,還是只連到原本的位置。Obsidian 匯入指南 介紹了其中一種外部工作流程。PDF Craft 的匯出功能並不代表會自動同步你的儲存庫,也不代表圖片會被永久託管。
分享檔案,而不是只分享預覽
如果對方需要一份可攜帶的本機副本,請把文件和它必要的資源一起給他,例如用檔案管理員打包成一個資料夾壓縮檔。分享前,請從另一個位置測試這份副本,不要只依賴自己電腦上的路徑。
如果要把 Markdown 發布到網站上,請依照該網站的資源上傳與網址規則處理。指向你本機裝置的 file:/// 路徑,遠端讀者無法存取。也不要只為了修好預覽,就把私人的原始圖片上傳到公開的空間。
分享文件與插圖前,請先確認你有這個權限。轉換後的圖片仍屬於原始作品的一部分;轉檔並不會讓它變成可自由再利用的新素材。
依序排查圖片無法顯示的問題
- 讀取 Markdown 原始碼裡的連結。
- 判斷它要的是本機檔案還是遠端網址。
- 確認該檔案是否真的在預期的路徑上,或遠端位址是否連得通。
- 比對檔名、大小寫和副檔名。
- 直接開啟圖片檔,排除檔案不完整或格式不支援的可能。
- 用你打算使用的閱讀器重新開啟 Markdown,並檢查圖說與上下文。
如果下載的內容裡沒有這項資源,請對照原始 PDF,並記下遺漏的部分。不要用生成的近似圖取代技術圖表。在補齊缺漏的內容之前,請清楚註明來源頁碼。
路徑都處理好之後,把來源書名、版本和圖片位置記進你的 研究筆記。一份方便攜帶的文件,除了連結要能正常使用,也要能交代圖片是從哪裡來的。