一鍵把 Word 全部轉成 Markdown：Pandoc 批次轉換完整手冊（從入門到實作）

Principal Jack 11月 29, 2025

一鍵把 Word 全部轉成 Markdown：Pandoc 批次轉換完整手冊（從入門到實作）

摘要

想把大量 Word 文件整理成 Markdown，用於 Ulysses、Notion、Obsidian 或 GitHub？

這篇文章提供「一般人也能操作」的 Pandoc 批次轉換流程，不需懂寫程式，也不需安裝複雜工具，只要跟著步驟操作，就能把過去多年累積的教案、行政文件、課程計畫、會議記錄、學習單……全部自動轉換為乾淨、標準、可長期保存的 Markdown XL 格式。

文章包含安裝教學、最佳轉換指令、常見問題、圖片提取、表格最佳處理方式，以及一鍵批次轉換的自動化腳本。

無論你是想整理知識、架設個人知識庫，或建立未來十年的數位內容基礎，都能從這篇完整手冊開始。

一鍵把 Word 全部轉成 Markdown：Pandoc 批次轉換完整手冊（從入門到實作）

前言

在教育行政、課程設計與研究工作中，我們往往累積大量 Word 文件：計畫書、會議紀錄、教學方案、成果報告……要長期保存與管理，Word 並不是最好的格式。而 Markdown 則輕量、乾淨、跨平台、永不過時，特別適合用於 Ulysses、Notion、Obsidian、GitHub 或未來任何形式的知識庫。

然而，要把大量 Word 文件手動轉成 Markdown 幾乎不可能。本篇文章整理出一份「一般人也能完成」的 Pandoc 使用手冊，包含安裝、操作、批次轉換與最佳實務，協助你讓所有文件無痛搬家到 Markdown 世界，建立自己的長期內容生態系。

Pandoc 是什麼？為什麼它適合做大量文件轉換？

Pandoc 被稱為「文件格式的瑞士軍刀」，支援超過 40 種文件格式。

它最強大的功能之一，就是：

能精準將 Word（.docx）轉換成 Markdown，並能同時提取圖片、處理表格、保留標題架構。

這也是現階段所有工具裡最穩定、最準確的轉換方式。

適用對象包括：

  • 教師、行政、研究者
  • 部落客、寫作者
  • 想整理多年資料的人
  • 想建立個人知識庫、第二大腦的人
  • 使用 Ulysses、Notion、Obsidian、GitHub 的創作者

一、安裝 Pandoc（macOS）

Pandoc 可透過 Homebrew 一鍵安裝（建議方法）。

1. 安裝 Homebrew（只需一次）

打開 Terminal（終端機），輸入：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Ps.建議先安裝Xcode，會需要Command Line Tools for Xcode

2. 安裝 Pandoc

brew install pandoc
or
/opt/homebrew/bin/brew install pandoc

完成！

（macOS 使用者最輕鬆的安裝方式）

二、建立一個專用資料夾

建議建立一個資料夾，例如：

word-to-md/
   input/      ← 所有 Word 放這裡
   output/     ← 轉換後的 Markdown
   media/      ← 自動抽出的圖片

這是長期使用時最穩定的結構，Ulysses、Notion、iCloud 都能很好處理。

Ps. 我是建立在SynologyDrive底下，讓電腦可在Mac及NAS中自動同步與備份。

三、最推薦的 Pandoc 轉換指令（給一般人使用）

把 input.docx 轉成 output.md：

pandoc input.docx \
  --extract-media=media \
  -f docx \
  -t markdown-simple_tables+grid_tables \
  -o output.md

這條指令做了什麼？

功能 說明
--extract-media=media 抽出 Word 內所有圖片，放入 media 資料夾
markdown-simple_tables+grid_tables 提升複雜表格的相容性，避免破版
-f docx 指定輸入格式
-o output.md 指定輸出 markdown

這就是最穩定、最萬用的組合。

四、批次轉換所有 Word 文件（最實用）

如果你有 10、50、100 份 Word 文件，只要跑這段：

在 word-to-md/ 裡新增一個檔案 convert.sh：

#!/bin/bash
mkdir -p output
mkdir -p media

for file in input/*.docx; do
    filename=$(basename "$file" .docx)
    pandoc "$file" \
      --extract-media=media \
      -f docx \
      -t markdown-simple_tables+grid_tables \
      -o "output/$filename.md"
done

在 Terminal 執行：

bash convert.sh

完成！所有 Word → Markdown 都自動轉好了。

五、轉換後還需要注意什麼？（最重要的三點）

這部分是針對你與 Gemini 討論後，我整理的最佳實務。

1. 表格（Tables）

  • 複雜表格可能變形
  • Grid table 相容度最好
  • 必要時可在 Ulysses 使用「附件表格」簡化格式

2. 圖片（Images）

  • 必須保留 media/ 資料夾
  • 建議重新命名圖片為語意化檔名，如：

smartfarm-layout.png

  • Ulysses 會自動讀取相對路徑，最穩定

3. 標題（Headings）

如果 Word 用的是「粗體＋字體放大」而非「樣式」，就會變亂碼。

建議在 Word 先：

把所有標題變成「標題 1／2／3」樣式

這樣轉換後的 Markdown 架構最乾淨。

六、匯入 Ulysses 的最佳方法

建議每一篇 Markdown 都放成：

文章名稱/
  article.md
  media/

Ulysses 會：

  • 正確載入圖片
  • 保留標題與段落
  • 不會出現圖片缺失或路徑錯誤

這是長期穩定使用最好的架構。

七、常見問題（FAQ）

Q1. 轉換後的圖跑到哪？

都會在 media/ 裡，不會遺失。

Q2. Word 內的註腳會消失嗎？

不會，格式如下：

這段文字[^1]

[^1]: 註腳說明

Ulysses 完全支援。

Q3. 公式能轉嗎？

可以，但 Ulysses 不支援 LaTeX 公式預覽。

建議保留文字版本。

Q4. 我要轉超過 500 份文件，會不會爆炸？

不會。

Pandoc 非常穩定，很多研究者一次轉 1,000–5,000 個文件。

結語：用 Markdown 建立你的長期知識庫

從 Word 轉向 Markdown，不只是格式轉換，而是一種「知識長期保存策略」。

Markdown 乾淨、耐久、可閱讀、能跨平台、不會因軟體更新而失效，非常適合像你這樣的教育工作者與內容創作者。

透過 Pandoc，自動化就不再是工程師的專利；每個人都能一次轉換多年累積的文件，打造更清晰、更長期、更能世代傳承的知識系統。

附註：問題排除

出現 pandoc: command not found 代表：

👉 你的 macOS 系統裡根本沒有安裝 Pandoc，或是 Pandoc 的執行路徑沒有被加入 PATH。

不用擔心，這很常見，也很好解決。

以下是完整排除順序。

✅ 解法 1：你可能還沒安裝 Pandoc（最常見）

如果你從未安裝過，那當然找不到。

✔️ 用 Homebrew 安裝（最推薦方式）

如果你有 Homebrew：

brew install pandoc

安裝完成後確認：

pandoc -v

只要有正常顯示版本號，例如：

pandoc 3.2.1

即可回去執行：

bash convert.sh

✅ 解法 2：你沒有 Homebrew（需要先裝）

如果執行 brew install pandoc 出現：

command not found: brew

代表你沒有 Homebrew。

請安裝 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝完後，把 brew 路徑加入 shell（如果 Brew 自動提示，也照著貼）：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

然後再安裝 Pandoc：

brew install pandoc

✅ 解法 3：你有 Pandoc，但 PATH 沒設定（較少見）

檢查 pandoc 是否存在：

which pandoc

如果顯示空白 → PATH 沒設定。

搜尋 pandoc：

find / -name pandoc 2>/dev/null

找到位置後，例如：

/usr/local/bin/pandoc

修改 ~/.zprofile 或 ~/.zshrc：

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile

延伸閱讀

  • Pandoc: Pandoc 是一個自由軟體文件轉換器，被廣泛用作寫作工具（尤其是學者）以及出版工作流程的基礎。它由加州大學柏克萊分校的哲學教授 John MacFarlane 所創建。
Principal Jack

張貼者： Principal Jack

與你同行於覺醒之路

張貼留言

0 留言

張貼留言