跳至主要內容

PDF 轉 Markdown 的圖片:妥善保存、搬移與分享資源

檢查 PDF 轉檔後的 Markdown 圖片路徑,搬移或分享時一併保留附帶檔案,並排查圖片連結失效的問題。

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 可能長這樣:

![圖 1:量測配置](images/figure-1.png)

編輯器會以 notes.md 所在的位置為基準,去找 images/figure-1.png。只要把整個 paper 資料夾一起搬移,這個相對關係就能維持不變。如果只搬 notes.md,圖片就不在連結所預期的位置了。

在不同系統上,檔名大小寫、空格、副檔名和特殊字元的編碼都可能造成影響。在一台電腦上看得到圖片,換到另一台卻打不開,往往是因為實際檔名和連結裡寫的名稱不一致。

搬移整個工作資料夾

原始下載的內容請保持原樣。先建立一份工作用的副本,裡面包含 Markdown 檔和它用到的所有本機資源,並先維持原本的結構。等確認原本的排列方式能正常開啟後,再重新整理。

如果要重新命名資源資料夾,記得同步更新對應的連結,並實際測試幾張圖片。多份文件若都有 image1.png 這類通用檔名,不要直接丟進同一個資料夾,否則可能互相覆蓋或混淆。

匯入筆記軟體時,請確認它是把附件複製過去,還是只連到原本的位置。Obsidian 匯入指南 介紹了其中一種外部工作流程。PDF Craft 的匯出功能並不代表會自動同步你的儲存庫,也不代表圖片會被永久託管。

分享檔案,而不是只分享預覽

如果對方需要一份可攜帶的本機副本,請把文件和它必要的資源一起給他,例如用檔案管理員打包成一個資料夾壓縮檔。分享前,請從另一個位置測試這份副本,不要只依賴自己電腦上的路徑。

如果要把 Markdown 發布到網站上,請依照該網站的資源上傳與網址規則處理。指向你本機裝置的 file:/// 路徑,遠端讀者無法存取。也不要只為了修好預覽,就把私人的原始圖片上傳到公開的空間。

分享文件與插圖前,請先確認你有這個權限。轉換後的圖片仍屬於原始作品的一部分;轉檔並不會讓它變成可自由再利用的新素材。

依序排查圖片無法顯示的問題

  1. 讀取 Markdown 原始碼裡的連結。
  2. 判斷它要的是本機檔案還是遠端網址。
  3. 確認該檔案是否真的在預期的路徑上,或遠端位址是否連得通。
  4. 比對檔名、大小寫和副檔名。
  5. 直接開啟圖片檔,排除檔案不完整或格式不支援的可能。
  6. 用你打算使用的閱讀器重新開啟 Markdown,並檢查圖說與上下文。

如果下載的內容裡沒有這項資源,請對照原始 PDF,並記下遺漏的部分。不要用生成的近似圖取代技術圖表。在補齊缺漏的內容之前,請清楚註明來源頁碼。

路徑都處理好之後,把來源書名、版本和圖片位置記進你的 研究筆記。一份方便攜帶的文件,除了連結要能正常使用,也要能交代圖片是從哪裡來的。

把方法用在你的文件上

先用有代表性的檔案試一次,檢查結果,再選擇適合整套資料的處理方式。

將 PDF 轉為 Markdown