Part 03 Unit 01 - 安裝 Pandoc
📘 FB 🎥 YT

Part 03 - Pandoc 安裝與基礎轉換

Unit 01: 安裝 Pandoc

文件格式轉換的瑞士刀

Windows macOS Linux

什麼是 Pandoc？

Pandoc 是一個免費、開源的文件格式轉換工具，被稱為「文件轉換的瑞士刀」。

📄

支援格式眾多

Markdown、Word、PDF、HTML、LaTeX 等數十種格式

⌨️

命令列工具

透過終端機指令執行，可自動化

🆓

完全免費

開源軟體，免費使用

🌍

跨平台

Windows、macOS、Linux 都支援

為什麼需要 Pandoc？

✍️

用 Markdown 寫作

Markdown 簡單快速，專注內容

📎

輸出 Word 文件

公司、學校通常要求 .docx 格式

🔄

Pandoc 橋接兩者

一個指令完成轉換！

工作流程：用 Markdown 寫 → 用 Pandoc 轉 → 得到 Word 檔！

本單元學習目標

1️⃣

安裝 Pandoc

在你的電腦上安裝 Pandoc

2️⃣

驗證安裝

確認 Pandoc 可以正常使用

3️⃣

了解基本語法

認識 Pandoc 指令的基本結構

4️⃣
整合 Antigravity

在 Antigravity 終端機中使用

Windows 安裝方法

Windows 有兩種推薦的安裝方式：

⭐

方法 1：Winget（推薦）

Windows 11/10 內建的套件管理員

優點：一行指令搞定

📦

方法 2：官網下載

從 Pandoc 官網下載安裝檔

優點：適合不熟悉命令列的人

建議：優先使用 Winget，更簡單快速！

Windows：使用 Winget 安裝

1開啟 PowerShell（以系統管理員身份）

按 Win 鍵 → 搜尋「PowerShell」→ 右鍵「以系統管理員身份執行」

2輸入以下指令並按 Enter：

winget install JohnMacFarlane.Pandoc

3等待安裝完成（約 1-2 分鐘）

4重要：關閉並重新開啟終端機

Windows：官網下載安裝（備選）

1前往 Pandoc 官方下載頁面：

https://github.com/jgm/pandoc/releases/latest

2下載 pandoc-x.x.x-windows-x86_64.msi

3雙擊執行 .msi 安裝檔

4按照安裝精靈完成安裝

5重要：安裝完成後，關閉並重新開啟終端機

macOS：使用 Homebrew 安裝

1開啟「終端機」（Terminal）

Spotlight 搜尋「Terminal」或在應用程式 → 工具程式中找到

2如果還沒安裝 Homebrew，先安裝它：

# 安裝 Homebrew（如果已安裝可跳過）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3使用 Homebrew 安裝 Pandoc：

# 更新 Homebrew
brew update

# 安裝 Pandoc
brew install pandoc

Linux：使用套件管理員安裝

Ubuntu / Debian

sudo apt update
sudo apt install pandoc

Fedora / RHEL / CentOS

sudo dnf install pandoc

Arch Linux

sudo pacman -S pandoc

驗證安裝是否成功

1開啟終端機（PowerShell / Terminal）

2輸入以下指令：

pandoc --version

3預期輸出：

pandoc 3.1.9
Features: +server +lua
Scripting engine: Lua 5.4
...
成功標準：看到版本號（如 3.1.9）表示安裝成功！

在 Antigravity 終端機中驗證

1開啟 Antigravity

2按 Ctrl + ` 開啟終端機

3輸入 pandoc --version

4確認顯示版本資訊

重點：之後我們都會在 Antigravity 的終端機中執行 Pandoc！

Pandoc 基本指令語法

pandoc [輸入檔案] -o [輸出檔案]

pandoc

程式名稱

[輸入檔案]

要轉換的來源檔案
例如：report.md

-o

output 的縮寫
指定輸出檔案

[輸出檔案]

轉換後的檔案
例如：report.docx

實際範例

範例 1：Markdown 轉 Word

pandoc report.md -o report.docx

範例 2：Markdown 轉 HTML

pandoc report.md -o report.html

範例 3：Markdown 轉 PDF

pandoc report.md -o report.pdf
自動判斷：Pandoc 會根據副檔名自動判斷輸出格式！

重要：處理含空格的檔名

注意！如果檔名包含空格，必須用引號包起來！

❌ 錯誤寫法

pandoc my report.md -o my report.docx

✅ 正確寫法

pandoc "my report.md" -o "my report.docx"
建議：養成習慣，所有檔名都用引號包起來！

實作練習 1：驗證 Pandoc 安裝

1開啟 Antigravity

2按 Ctrl + ` 開啟終端機

3輸入以下指令：

pandoc --version

4確認看到版本號

成功標準：終端機顯示 Pandoc 版本資訊！

實作練習 2：查看 Pandoc 幫助

1在終端機輸入：

pandoc --help

2觀察輸出的說明文件

3找到 -o 參數的說明

技巧：忘記參數時，用 --help 查看說明！

實作練習 3：查看支援格式

1查看 Pandoc 支援的輸入格式：

pandoc --list-input-formats

2查看 Pandoc 支援的輸出格式：

pandoc --list-output-formats
發現：Pandoc 支援超過 50 種格式！

隨堂測驗 1

問題：在 Windows 上，推薦使用什麼方式安裝 Pandoc？

  1. 從網路上隨便下載
  2. 使用 winget install JohnMacFarlane.Pandoc
  3. 不需要安裝，內建就有
  4. 從 App Store 下載

✅ 測驗 1 解答

答案：(2) 使用 winget install JohnMacFarlane.Pandoc

解釋：Winget 是 Windows 內建的套件管理員，使用官方指令安裝最安全、最方便！

隨堂測驗 2

問題：以下哪個指令可以將 report.md 轉換成 Word 檔案？

  1. pandoc report.md > report.docx
  2. pandoc -o report.md report.docx
  3. pandoc report.md -o report.docx
  4. convert report.md to report.docx

✅ 測驗 2 解答

答案：(3) pandoc report.md -o report.docx

語法：pandoc [輸入檔] -o [輸出檔]

-o 代表 output，後面接輸出的檔案名稱。

常見安裝問題

❓ 找不到 pandoc 指令

解決：關閉終端機，重新開啟再試

❓ winget 無法使用

解決：更新 Windows 或使用官網下載

❓ 權限不足

解決：以系統管理員身份執行

❓ 版本太舊

解決：使用官網下載最新版

Unit 01 總結

✅

已完成

  • 了解 Pandoc 是什麼
  • 成功安裝 Pandoc
  • 驗證安裝成功
  • 學會基本指令語法
➡️

下一步

Unit 02：進行第一次 Markdown → Word 轉換！

恭喜！Pandoc 已經準備就緒，接下來實際轉換檔案！