格式是大多數 Word 到 Markdown 轉換出錯的地方。粗體文本顯示為純文本。桌子倒塌了。標題變成無樣式的段落。本指南準確解釋了期間發生的情況 Word 轉 Markdown 轉換以及如何控制輸出。
瞭解轉換管道
當您將 Word 文件轉換為 Markdown 時，會發生兩件事：
- DOCX → HTML — mammoth.js 解析 Word XML 並將每個元素對映到 HTML
- HTML → Markdown —turndown 將 HTML 轉換為 Markdown 語法
如果 HTML 是乾淨的，那麼第二步是無損的。第一步是格式複雜性很重要——Word 的樣式需要對映到已知的 HTML 等效項。
使用 WordToMD 轉換器 準確檢視文件如何即時轉換。
標題樣式
Word 中最重要的格式決定是使用內建標題樣式。
| 字型 | Markdown 輸出 |
|---|---|
| 標題 1 | # Heading |
| 標題 2 | ## Heading |
| 標題 3 | ### Heading |
| 正常（粗體文本） | **text** （不是標題） |
常見錯誤： 手動將文本格式設定為大且粗體，而不是應用標題樣式。這看起來像 Word 中的標題，但在 Markdown 中轉換為粗體文本，而不是 ##.
有關完整的標題參考，請參閱 Markdown 標題指南.
文本強調
| Word格式 | Markdown 輸出 |
|---|---|
| 粗體 | **Bold** |
| 斜體 | *Italic* |
| 粗體斜體 | ***Bold Italic*** |
~~Strikethrough~~ | |
| 下劃線 | （無 Markdown 等效項 — 省略） |
| 突出顯示 | （無標準 Markdown — 省略） |
下劃線和突出顯示在標準語法中沒有 Markdown 等效項。轉換後，使用HTML <u> 標籤或自定義 CSS 類（如果您的釋出平臺支援）。
列表
Word 的自動列表格式轉換乾淨：
- Bullet item one
- Bullet item two
- Nested bullet (indent 2 spaces)
1. First item
2. Second item
1. Nested numbered item破壞列表的因素： 手動輸入的破折號或數字不是實際的 Word 列表項。這些在視覺上看起來像列表，但 Word 將它們視為純文本段落。解決方法：在 Word 中選擇它們並應用列表專案符號或列表編號樣式。
表格
標準錶轉換為 GitHub 風格的 Markdown 表語法：
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |什麼破壞了桌子：
- 合併單元格 — 跨越多列或多行的單元格將被摺疊
- 多行單元格內容 — 單元格內的換行符被去除
- 巢狀表 — 內部表被展平為純文本
有關完整的詳細資訊，請參閱 Markdown 表：完整指南.
程式碼和預格式化文本
Word 中使用等寬字型（Courier New、Consolas）格式化的文本對映到內聯程式碼：
Use `console.log()` to debug.對於具有語法突出顯示的隔離程式碼塊，請應用 Word 的“程式碼”段落樣式（如果您的模板有），或者在轉換後手動新增三重反引號隔離。參見 Markdown 程式碼塊指南 獲取完整語法。
超連結
Word超連結完美轉換：
Visit [WordToMD](https://wordtomd.org) for instant conversion.連結文本和 URL 均被保留。如果 Markdown 中不存在目標，則書籤（同一文件中的內部連結）可能無法轉換。
影像
影像是 Word 到 Markdown 轉換始終不足的地方。mammoth.js 可以將嵌入影像提取為 base64 資料 URI，但預設行為是在轉換註釋中註明它們的存在。轉換後：
- 從 Word 匯出影像：檔案 → 另存為 → 網頁 (HTML)
- 在 Markdown 中引用它們：
特殊字元和符號
Word 經常自動插入特殊的 Unicode 字元：
- 智慧報價 (
"...") → 保留為 Unicode 字元 - Em破折號（
—) → 保留 - 不間斷空格 → 轉換為常規空格
- 版權符號（
©) → 保留
如果您需要僅 ASCII 輸出，請在轉換後在文本編輯器中執行查詢和替換。
自定義Word樣式
如果您的 Word 文件使用自定義段落樣式（例如“標註”或“警告”），mammoth.js 會將它們記錄為轉換註釋。您會看到類似“無法識別的段落樣式：標註”之類的訊息。WordToMD 預設情況下會過濾掉這些資訊性訊息。
要處理自定義樣式，您需要一個帶有自定義過濾器的本地 Pandoc 設定 - 請參閱 Pandoc Word到 Markdown 針對該方法。
轉換前的格式檢查表
在轉換之前將此清單應用於您的 Word 文件：
- 所有標題均使用 Word 內建的標題 1/2/3 樣式（非手動格式）
- 列表是使用 Word 的列表工具建立的（不是鍵入破折號/數字）
- 表格是簡單的網格（沒有合併單元格）
- 程式碼使用等寬字型
- 超連結是真正的超連結（不僅僅是藍色下劃線文本）
FAQ
為什麼我的標題轉換為粗體文本？ 您應用了手動粗體 + 字型大小格式而不是標題樣式。在 Word 中，單擊該段落並檢視“樣式”面板 - 它應該顯示“標題 1”而不是“普通”。
我的編號列表在錯誤的位置從 1 重新開始 — 我該如何修復它？ 在 Word 中設定列表延續：右鍵單擊列表 → 繼續編號。或者轉換後直接編輯 Markdown。
Markdown 中的表格對齊方式看起來不正確。發生了什麼？
GFM 表使用 |---| 用於對齊分隔符。WordToMD 自動生成這些。如果渲染看起來不正常，請檢查單元格中是否沒有管道字元（|) 在其內容中 — 將其轉義為 \|.
結論
保持清潔 Word 到 Markdown 格式 主要是關於正確使用 Word。應用內建標題樣式，使用 Word 的列表和表格工具，您將獲得近乎完美的輸出 WordToMD 轉換器. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.