UltKit

DOCX 轉 Markdown 轉換器

要把文件從 Word 搬進 Git 儲存庫,第一步就是把每個 .docx 轉成 Markdown。這個轉換器會輸出 CommonMark 風格的文字,包含 # 標題、管線表格與圖片連結,可以直接提交。

文件轉換器

或將PDF, DOC, DOCX … 檔案拖曳到這裡 ·

每個檔案最大 95 MB· 最多 20 個檔案· 30 分鐘後刪除

輸出

檔案會在我們的伺服器上處理,並於 30 分鐘後刪除。

使用方式

  1. 1

    上傳 Word 檔案

    最多可加入 20 個 .docx 或 .doc 檔案,每個檔案最大 95 MB。Markdown 無法呈現修訂內容,請先在 Word 中接受或拒絕所有修訂。

  2. 2

    確認文字選項

    格式預設為 Simple,文字編碼為 UTF-8,換行字元為 LF,這個組合正是 Git 與靜態網站產生器所需要的。保持開啟包含圖片,圖片就會輸出到資料夾中。

  3. 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 輸出的樣子

含標題、清單與表格的 Word 段落,轉換後的結果
## 發布檢查清單

標記發布版本前,請確認以下事項:

- **main** 上的測試全部通過
- 變更記錄列出每個已合併的 PR

| 步驟 | 負責人 |
| --- | --- |
| 建置 | CI |
| 發布 | 維護者 |

![發布流程](images/figure-1.png)

轉換後的 Markdown 可以在哪裡顯示

可直接讀取 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
DOCX 轉檔工具

MD

Markdown

Markdown 是 John Gruber 於 2004 年建立的輕量標記語法。它使用純文字符號,例如以 # 表示標題、* 表示強調、- 表示清單,以原始文字顯示時仍易於閱讀,也能乾淨地轉換為 HTML。它是 README 檔、技術文件、Wiki、筆記 App 和許多靜態網站產生器的標準。它有多種方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等細節上略有差異。任何文字編輯器都能開啟 .md 檔。

壓縮方式
–
透明度
–
動畫
–
推出年份
2004 · John Gruber
MD 轉檔工具

當文件要進入程式碼工作流程時,就會把 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 下載選項,簡單的文件用它效果不錯。