將 Word 文件中的文本轉換為 Markdown 非常簡單。轉換影像是一項單獨的工作：Word 將媒體儲存在 .docx 包，而 Markdown 僅儲存對影像檔案的文本引用。
可靠的工作流程是轉換文件結構，提取影像檔案，給它們提供穩定的名稱，然後使用相對路徑和有用的替代文本將每個影像連線到 Markdown。 本指南展示瞭如何在不丟失資產跟蹤的情況下做到這一點。
簡短答案
如果您只有一個文件且只有幾張影像：
- 轉換
.docx文本 WordToMD. - 從 Word 檔案的副本中提取影像。
- 將影像放入
images/orassets/資料夾。 - 新增 Markdown 參考，例如
. - 在目標位置預覽最終的 Markdown。
如果您有許多文件或許多嵌入影像，請使用 Pandoc with --extract-media. It can create the media files and references in one command, although you should still rename, optimize, and review the assets.
為什麼影像的行為與文本不同
A .docx 檔案是一個 ZIP 包，包含 XML、關係、樣式和媒體。嵌入影像位元組通常位於 word/media/，而關係檔案告訴 Word 每個影像出現的位置。該文件還可以包含裁剪說明、浮動位置、標題、裝飾形狀以及沒有直接 Markdown 等效項的連結。
Markdown 本身不嵌入影像位元組。標準影像語法包含三部分資訊：
Alternative text描述了看不見的影像。images/architecture-diagram.png告訴渲染器檔案所在的位置。- 可選標題可能會顯示為工具提示，具體取決於渲染器。
這種分離對於版本控制和釋出很有用，但這意味著完整的遷移必須同時管理 .md 檔案及其資產。
WordToMD 對嵌入影像的作用
WordToMD 可以在瀏覽器中轉換標題、段落、列表、連結、強調、基本表格和支援的嵌入圖片。找到圖片後，結果包括 Markdown + 影像 ZIP 選項包含 .md 檔案和 images/ 資料夾。
您的文件保留在本地，並且生成的 Markdown 影像引用使用打包的相對路徑 images/ 資料夾。在釋出之前檢視替代文本、重新命名通用資源並檢查複雜的 Word 繪圖物件。
選擇正確的提取方法
| 方法 | 最適合 | 優點 | 權衡 |
|---|---|---|---|
| WordToMD Markdown + 影像 ZIP | 一份支援嵌入圖片的文件 | 無需安裝；轉換和影像打包保留在瀏覽器中 | 複雜的繪圖物件和最終資產命名可能需要審查 |
| 將 DOCX 副本重新命名為 ZIP | 直接訪問原始嵌入媒體 直接 | 無需額外轉換器 | 檔名，例如 image1.png 不解釋安置 |
| 從 Word 儲存為網頁 | 喜歡 Word 介面的使用者 | 建立 HTML 檔案和媒體資料夾 | 生成的名稱和 HTML 可能需要清理 |
Pandoc --extract-media | 許多影像、重複作業或自動化 | 自動提取媒體並寫入參考 | 需要命令列安裝和審查 |
工作流程 A：WordToMD Plus 手動影像提取
此方法可保持文本轉換快速，同時讓您可以控制資源名稱和位置。
1. 轉換並儲存 Markdown
開啟 Word到 Markdown 轉換器，選擇 .docx，檢視可編輯結果，並下載 .md 檔案。保持原始 Word 文件不變，直到遷移完成。
2. 從 DOCX 副本中提取影像
更改副檔名之前先複製一份。
在 Windows 上：
- 啟用 副檔名 。
- 副本
handbook.docx到工作資料夾。 - 將副本重新命名為
handbook.zip. - 提取 ZIP 存檔。
- 開啟提取的
word/media/資料夾。
在 macOS 或 Linux 上，普通的存檔實用程式可以打開復制的檔案
首頁 .docx ，或者您可以複製該檔案並將其副檔名更改為 .zip.
媒體目錄可能包含 PNG、JPEG、GIF、SVG、EMF 或 WMF 檔案。某些釋出系統不處理特定於 Word 的向量格式，因此在將不受支援的格式新增到 Markdown 專案之前，請將其轉換為 SVG 或 PNG。
3. 將每個檔案與其位置相匹配
名稱，例如 image1.png and image2.jpeg 是包識別符號，而不是有意義的資產名稱。以縮圖形式開啟提取的檔案，並將其與 Word 文件進行比較。
在工作時建立一個簡單的對映：
| 字位置 | 提取的檔案 | 最終檔名 |
|---|---|---|
| 架構部分 | image3.png | system-architecture.png |
| 登入說明 | image7.jpeg | login-settings.jpg |
| 結果部分 | image9.png | conversion-result.png |
不要假設數字順序始終與視覺順序匹配。標題、重複的徽標、背景和刪除的內容可能會影響內部編號。
4. 建立行動式資料夾結構
一個簡單的結構適用於 GitHub、Obsidian 和大多數靜態站點生成器：
handbook/
├── handbook.md
└── images/
├── system-architecture.png
├── login-settings.jpg
└── conversion-result.png然後用相對路徑引用檔案：
相對路徑使文件保持可移植性。絕對路徑，例如 C:\Users\Name\Desktop\image1.png 僅適用於一臺計算機，並且永遠不應出現在已釋出的 Markdown 中。
5. 編寫有意義的替代文本
Word 影像標題和 Markdown 替代文本有不同的用途。標題是可見的支援文本；替代文本是影像傳達的資訊的簡潔替代。
弱：
更好：
對於螢幕截圖，請標識相關介面和狀態。對於圖表，總結結論而不是列出每個視覺標記。對於不新增資訊的裝飾影像，請使用空替代文本：
不要逐字重複周圍的標題，除非它是最清晰的等效描述。
6. 在真實目的地預覽
Markdown 渲染器有所不同。在以下情況下，在本地編輯器中工作的路徑在部署後可能會失敗：
- 儲存庫使用區分大小寫的檔名；
- 網站重寫資產 URL；
- Markdown 檔案移動到另一個目錄；
- 空格或非 ASCII 字元的處理方式不同；
- 平臺阻止檔案格式。
在 GitHub、Obsidian 或通過網站的正常構建過程預覽最終頁面。檢查桌面和移動裝置寬度下的每張影像。
工作流程 B：使用 Pandoc 提取影像
當影像對映主導遷移時，Pandoc 更適合。
pandoc handbook.docx \
-t gfm \
--wrap=none \
--extract-media=./assets \
-o handbook.mdPandoc 提取嵌入媒體並將引用寫入生成的 Markdown。在釋出之前檢查生成的目錄：生成的層次結構和名稱在技術上可能是正確的，但難以維護。
轉換後： 轉換後的
- 刪除重複或未使用的資源。
- 使用描述性小寫名稱重新命名檔案。
- 重新命名後更新每個 Markdown 參考。
- 轉換不支援的格式。
- 新增或改進替代文本。
- 壓縮大檔案。
對於重複轉換，請參閱 批次 Word-to Markdown 指南.
常見目的地的影像路徑
GitHub
將影像儲存在儲存庫中並使用相對於 Markdown 檔案的路徑：
檔名大小寫很重要。 Build-Status.png and build-status.png 的行為可能類似於不同的檔案。的 Word 到 GitHub 指南 涵蓋了 GFM 清理的其餘部分。
Obsidian
標準 Markdown 影像語法仍然是最便攜的選擇：
Obsidian 還支援 wiki 風格的嵌入，但這些是特定於應用程式的。在轉換每個引用之前，確定可移植性或黑曜石本機行為是否更重要。請參閱 Word到黑曜石的工作流程.
靜態站點發生器
站點可以解析與當前 Markdown 檔案相關的資源， public/ 目錄，或匯入管道。在移動影像之前確認專案的約定。路徑如 /images/guide/example.png 可以在一個站點上執行，但當該站點部署在子目錄下時會中斷。
閱讀 Word到靜態站點指南 並通過生產構建命令進行測試。
釋出前最佳化資源
Word 文件經常包含比其顯示尺寸大得多的影像。釋出這些原件可能會減慢頁面載入速度，而不會提高可見質量。
使用這些實用規則：
- 匯出前剪掉未使用的區域。
- 對於攝影內容，更喜歡 JPEG 或 WebP。
- 對於需要清晰文本的介面螢幕截圖，更喜歡 PNG。
- 更喜歡 SVG 來實現相容的圖表和徽標。
- 將影像大小調整為合理的最大顯示寬度。
- 當源需要時刪除敏感後設資料。
- 將原始高解析度檔案保留在已釋出的資源目錄之外。
避免自動將每個影像轉換為一種格式。螢幕截圖、圖表、照片和透明插圖有不同的要求。
常見影像問題和修復
Markdown 顯示損壞的影像圖示
檢查相對於 .md 檔案，包括大小寫和副檔名。然後確認資產已提交、上傳或複製到部署輸出。
該影像可以在本地執行，但不能線上執行
本地路徑可能指向專案外部，或者部署的站點可能使用不同的基本 URL。將特定於計算機的路徑替換為儲存庫相對路徑或站點批准的路徑。
提取的影像看起來與 Word 不同
Word 可以應用裁剪、旋轉、透明度、邊框或顏色調整作為文件指令，而不是更改底層影像。在影像編輯器中重新建立最終外觀並匯出可供釋出的資產。
缺少圖表
SmartArt、圖表、分組形狀和繪圖畫布並不總是儲存為普通光柵影像。將物件從 Word 匯出為 SVG 或 PNG，然後手動引用匯出的檔案。
檔名更改但影像消失
重新命名資產不會自動更新 Markdown。在專案中搜索舊名稱並更新每個引用，包括引用樣式的影像定義。
最終映像遷移檢查表
- Markdown 檔案有一個匹配的資原始檔夾。
- 提取了每個攜帶資訊的嵌入影像。
- 檔名具有描述性、穩定且一致。
- 路徑是相對的或遵循目的地的記錄約定。
- Alt 文本傳達每個有意義影像的目的。
- 裝飾影像使用空替代文本。
- 轉換了不受支援的 Word 向量格式。
- 超大資產已調整或壓縮。
- Markdown 中沒有保留任何本地驅動器路徑。
- 所有影像均在最終渲染器中以移動和桌面寬度進行檢查。
FAQ
WordToMD 可以下載 DOCX 中的影像嗎？
是的。轉換 DOCX 並選擇 Markdown + 影像 ZIP. The archive contains the editable Markdown and supported embedded pictures in an images/ 資料夾。當您只需要原始媒體檔案時，您還可以使用單獨的 Word Image Extractor。
Markdown 可以將影像儲存在 .md 檔案？
標準 Markdown 儲存引用，而不是二進位制影像。一些編輯器接受 base64 資料 URL，但它們會使 Markdown 檔案變得很大且不易移植。具有相對路徑的單獨資原始檔通常更容易維護。
我應該使用絕對 URL 還是相對影像路徑？
當影像屬於同一儲存庫或站點時，使用相對路徑。僅當影像有意在其他地方託管和維護時才使用絕對 HTTPS URL。避免使用您無法控制的 URL。
我應該如何處理 Word 標題？
將標題保留為影像附近的可見文本，併為影像的含義編寫單獨的替代文本。如果您的釋出系統有圖形或標題元件，請將其轉換為該平臺支援的語法。
結論
成功的 Word 到 Markdown 影像遷移將 Markdown 及其資產視為一個包。使用 WordToMD 對於快速、私密的文本轉換，單獨提取媒體，建立有意的名稱和路徑，並預覽實際釋出的結果。對於大型或可重複的遷移，請切換到 Pandoc 並自動執行提取步驟，而無需跳過最終的可訪問性和路徑審查。