DOCX 轉 Markdown 轉換器
要把文件從 Word 搬進 Git 儲存庫,第一步就是把每個 .docx 轉成 Markdown。這個轉換器會輸出 CommonMark 風格的文字,包含 # 標題、管線表格與圖片連結,可以直接提交。
文件轉換器
或將PDF, DOC, DOCX … 檔案拖曳到這裡 ·
每個檔案最大 95 MB· 最多 20 個檔案· 30 分鐘後刪除
檔案會在我們的伺服器上處理,並於 30 分鐘後刪除。
150 DPI 會將 A4 頁面轉為約 1240 × 1754 px。列印請用 300。
轉換整個檔案,或只轉換部分頁面或投影片(適用於 PDF 與簡報輸入)。
要轉換的頁面或投影片,例如 1-3, 5, 8-10。
UTF-8 適用於所有語言。若 Windows 上的 Excel 或記事本顯示亂碼,請選擇含 BOM 的 UTF-8;舊式編碼僅適用於老舊軟體。
LF 適用於 macOS、Linux 與程式碼編輯器;CRLF 適用於舊版 Windows 程式,例如傳統記事本。
逗號是標準設定。在以逗號表示小數的國家(德國、法國、巴西)使用 Excel 時,請選分號。
含多個工作表的 Excel 輸入:轉換全部(每個工作表一個區段或檔案),或只轉換第一個。
使用方式
- 1
上傳 Word 檔案
最多可加入 20 個 .docx 或 .doc 檔案,每個檔案最大 95 MB。Markdown 無法呈現修訂內容,請先在 Word 中接受或拒絕所有修訂。
- 2
確認文字選項
格式預設為 Simple,文字編碼為 UTF-8,換行字元為 LF,這個組合正是 Git 與靜態網站產生器所需要的。保持開啟包含圖片,圖片就會輸出到資料夾中。
- 3
轉換並解壓縮
按下轉換為 MD。每份文件都會以 ZIP 形式送達,內含 .md 檔案與其圖片;解壓縮到您的文件資料夾後即可提交。
如何將 Word 文件轉換成 Markdown?
上傳 .docx 後按下轉換為 MD。您會得到一個 .md 檔案,內含 # 標題、清單、連結與表格,旁邊的資料夾則存放圖片,全部包在同一個 ZIP 中。
DOCX 轉 Markdown,打造 docs-as-code 流程
團隊採用 docs-as-code 只有一個原因:文件和程式碼放在一起,經過相同的 pull request,並隨同一個版本發布。.docx 卻打破了這點,因為它是由 XML 部件組成的 ZIP,Git 只會把它當成不透明的二進位檔。只改一個字也只會顯示檔案已變更,看不到可讀的差異,兩人同時編輯也無法合併。
Markdown 是純文字,每次編輯都是清楚可見的行變更。2014 年 John MacFarlane 等人發表 CommonMark 後,它也變得可預測許多;CommonMark 是對 Gruber 十年前鬆散描述的語法所做的精確規格。GitHub 於 2017 年以 CommonMark 為基礎制定自己的 GitHub Flavored Markdown 規格,加入了現今多數 README 使用的 pipe 表格、待辦清單與刪除線。
如果內容要反方向走,也就是把 Markdown 交給使用 Word 的審閱者,請用 Markdown 轉 DOCX。若目的地是網頁而非程式庫,DOCX 轉 HTML 能保留更多樣式。
Markdown 輸出的樣子
## 發布檢查清單 標記發布版本前,請確認以下事項: - **main** 上的測試全部通過 - 變更記錄列出每個已合併的 PR | 步驟 | 負責人 | | --- | --- | | 建置 | CI | | 發布 | 維護者 | 
轉換後的 Markdown 可以在哪裡顯示
| 機構 | 規定 | 來源 |
|---|---|---|
| GitHub | 使用 GitHub Flavored Markdown 渲染程式庫中的 README.md 與所有 .md 檔案 | github.com |
| Hugo | 以符合 CommonMark 的解析器,從 .md 內容檔案建置頁面 | gohugo.io |
| Jekyll | 將含 front matter 的 .md 檔案轉成頁面;是 GitHub Pages 背後的引擎 | jekyllrb.com |
| Docusaurus | 將 docs 資料夾中的 .md 與 .mdx 檔案讀取為文件頁面 | docusaurus.io |
DOCX
Microsoft Word 文件
DOCX 是自 Office 2007 起 Microsoft Word 的預設文件格式,以 Office Open XML 標準(ECMA-376、ISO/IEC 29500)為基礎。它是一個 ZIP 封裝,內含存放文字、樣式、圖片、表格、註解和追蹤修訂的 XML 檔案。它是辦公室、學校和求職申請中最常見的可編輯文件格式。在 Word、Google 文件、LibreOffice 和 Pages 之間,版面可能略有位移,格式複雜時尤其明顯。大多數文書處理軟體都能開啟 DOCX 檔案。
- 壓縮方式
- –
- 透明度
- –
- 動畫
- –
- 推出年份
- 2007 · Microsoft
MD
Markdown
Markdown 是 John Gruber 於 2004 年建立的輕量標記語法。它使用純文字符號,例如以 # 表示標題、* 表示強調、- 表示清單,以原始文字顯示時仍易於閱讀,也能乾淨地轉換為 HTML。它是 README 檔、技術文件、Wiki、筆記 App 和許多靜態網站產生器的標準。它有多種方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等細節上略有差異。任何文字編輯器都能開啟 .md 檔。
- 壓縮方式
- –
- 透明度
- –
- 動畫
- –
- 推出年份
- 2004 · John Gruber
當文件要進入程式碼工作流程時,就會把 DOCX 轉成 Markdown,例如 README、文件網站,或存放在 Git 中的知識庫;純文字可以比對差異、在 pull request 中審查,也能由許多工具渲染。
Markdown 沒有對應的 Word 功能
轉換前請先規劃好這些項目
- 字型、顏色與頁面配置會被捨棄;Markdown 只描述結構,外觀由網站佈景主題決定
- 修訂與註解不會保留,請先在 Word 中處理完畢
- 頁首、頁尾與頁碼在 .md 檔案中沒有對應位置
- 文字方塊與文繞圖的圖片會變成一般段落與圖片連結
- 手動設定的標題(例如 16 pt 粗體而非標題 2)會變成粗體文字,請先套用真正的標題樣式
- 底線在 Markdown 中沒有對應語法,會被移除或以 HTML 保留
DOCX 轉 Markdown 常見問題
DOCX 轉 MD 輸出的是哪一種 Markdown 語法?
標題、強調、清單、連結與程式碼遵循 CommonMark,表格則採用 GitHub Flavored Markdown 的直線(pipe)語法。GitHub、GitLab、Hugo、Jekyll 與 Docusaurus 都能正確呈現這個組合。
合併的表格儲存格會怎麼處理?
Markdown 的 pipe 表格不支援合併儲存格,因此每個合併區域都會拆回個別儲存格,文字放在第一格。複雜的表格可在 .md 中改用 HTML 重建,或在轉換前先於 Word 中簡化。
Word 文件裡的圖片會放在哪裡?
開啟包含圖片後,每張圖片都會以獨立檔案存放在 ZIP 中,Markdown 則以相對路徑連結,例如 images/figure-1.png。移動 .md 檔案時,請讓該資料夾保持在它旁邊。
Word 註腳轉成 Markdown 後還會保留嗎?
CommonMark 沒有註腳語法,但 GitHub 在 2021 年加入了 [^1] 註腳,多數網站產生器也支援。如果您的渲染器不支援,註腳文字會以一般段落顯示在文末。
可以用這個方法把 Google 文件轉成 Markdown 嗎?
可以。在 Google 文件中選擇檔案 > 下載 > Microsoft Word (.docx),再將該檔案上傳到這裡即可。Google 文件本身也提供 Markdown 下載選項,簡單的文件用它效果不錯。