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

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

Markdown 檔案可以引用圖片，但圖片本身的資料並不在檔案裡。因此，只複製這個文字檔，文件讀起來可能很順，原本該有圖表的地方卻是一片空白。

PDF Craft 會把 Markdown 轉換結果打包成 ZIP 壓縮檔供你下載。編輯或搬移 Markdown 文件之前，請先把整個壓縮檔解開；只在壓縮檔內預覽，會看不出文件與附帶圖片之間的關聯。

## 確認文件與它依賴的資源

從已完成的 [PDF 轉 Markdown 任務](https://pdfcraft.ai/zh-Hant/pdf-craft/pdf-to-markdown/) 下載 ZIP 檔，解壓縮到一個專屬資料夾。壓縮檔裡會有 Markdown 文件，若轉換過程產生了圖片資源，也會有對應的資料夾。匯出時的命名不一定相同：文件可能沿用來源檔名，也可能叫 `document.md` 之類的名稱；資源則可能放在 `images/` 或 `assets/` 底下。請用文字編輯器開啟 `.md` 檔，依照檔案裡實際的連結去找檔案，不要為了配合範例而把資料夾改名。原始 ZIP 檔請留著，當作未經更動的備份。

連結可能指向相對路徑的檔案、本機的絕對路徑，或遠端網址，這幾種形式的可攜性各不相同。相對路徑的檔案必須連同旁邊的資源一起保留；遠端網址則需要網路連線，而且該位址必須持續有效。

另外請確認圖說和圖號是文件裡的文字，還是圖片的一部分。保留了圖片，並不代表圖片裡的每個字都已被辨識或翻譯。這些內容之間的關係，[圖片與圖說檢查指南](https://pdfcraft.ai/zh-Hant/blog/scanned-pdf-images-captions/) 有更詳細的說明。

## 從 Markdown 檔案所在位置解讀相對路徑

關鍵在於 Markdown 檔案和它的資源資料夾之間的相對位置。以下用示意用的檔名與圖片名稱做個簡化範例；實際名稱請以你下載的內容為準：

```text
paper/
├── notes.md
└── images/
    └── figure-1.png
```

對應的 Markdown 可能長這樣：

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

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

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

## 搬移整個工作資料夾

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

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

匯入筆記軟體時，請確認它是把附件複製過去，還是只連到原本的位置。[Obsidian 匯入指南](https://pdfcraft.ai/zh-Hant/blog/pdf-to-markdown-obsidian/) 介紹了其中一種外部工作流程。PDF Craft 的匯出功能並不代表會自動同步你的儲存庫，也不代表圖片會被永久託管。

## 分享檔案，而不是只分享預覽

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

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

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

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

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

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

路徑都處理好之後，把來源書名、版本和圖片位置記進你的 [研究筆記](https://pdfcraft.ai/zh-Hant/blog/pdf-to-markdown-for-research/)。一份方便攜帶的文件，除了連結要能正常使用，也要能交代圖片是從哪裡來的。