Part 03 - Pandoc 安裝與基礎轉換

Unit 02: 第一次轉換

從 Markdown 到 Word：實際動手做！

.md → .docx

本單元學習目標

1️⃣

建立 Markdown 檔案

在 Antigravity 中建立測試用的 .md 檔案

2️⃣

執行轉換指令

使用 Pandoc 將 .md 轉成 .docx

3️⃣

驗證轉換結果

用 Word 開啟並確認格式正確

4️⃣

了解轉換對應

Markdown 語法如何對應到 Word 樣式

步驟 1：建立工作資料夾

1開啟 Antigravity

2按 Ctrl+K Ctrl+O 開啟資料夾

3選擇或建立一個測試用資料夾（例如：桌面上的「Pandoc練習」）

4確認左側檔案總管顯示該資料夾

建議：使用專門的練習資料夾，方便管理檔案！

步驟 2：建立 Markdown 檔案

1在檔案總管空白處右鍵 → New File

2輸入檔名：sample.md

3按 Enter 確認

4檔案會自動開啟在編輯區

步驟 3：輸入測試內容

在 sample.md 中輸入以下內容：

📄 sample.md

# 我的第一份文件

這是用 **Markdown** 寫的文件，將會轉換成 Word 格式。

## 章節一：簡介

這是第一個章節的內容。Markdown 讓寫作變得簡單！

### 小節 1.1

- 項目一
- 項目二
- 項目三

## 章節二：程式碼

以下是程式碼範例：

`print("Hello World")`

## 結論

感謝閱讀！

步驟 4：儲存檔案

1輸入完內容後，按 Ctrl + S 儲存

2確認分頁標籤上的白點（●）消失

有白點表示未儲存，沒有白點表示已儲存

成功標準：檔案已儲存，分頁標籤顯示 sample.md 沒有白點！

步驟 5：開啟終端機

1按 Ctrl + ` 開啟終端機

2確認終端機的工作目錄是你的專案資料夾

PS C:\Users\你的名字\Desktop\Pandoc練習>

重點：終端機會自動在專案資料夾中開啟，這樣才能找到 sample.md！

步驟 6：執行轉換指令

1在終端機中輸入以下指令：

pandoc sample.md -o sample.docx

2按 Enter 執行

3如果沒有錯誤訊息，表示轉換成功！

注意：Pandoc 成功時不會有任何輸出，這是正常的！

步驟 7：確認輸出檔案

1查看左側檔案總管

2應該會看到新的 sample.docx 檔案

3如果沒看到，按 F5 重新整理檔案列表

成功！你已經完成第一次 Markdown → Word 轉換！🎉

步驟 8：用 Word 開啟檢視

1在檔案總管中找到 sample.docx

2右鍵 → Reveal in File Explorer（在檔案總管中顯示）

3雙擊 sample.docx 用 Word 開啟

4檢視轉換結果！

Markdown → Word 對應關係

Markdown 語法	Word 樣式
`# 標題`	標題 1 (Heading 1)
`## 標題`	標題 2 (Heading 2)
`### 標題`	標題 3 (Heading 3)
`粗體`	粗體 (Bold)
`斜體`	斜體 (Italic)
`- 項目`	項目符號清單
`1. 項目`	編號清單

用終端機確認檔案（進階）

你也可以用終端機指令確認檔案是否產生：

Windows (PowerShell)

dir *.docx

macOS / Linux

ls *.docx

預期輸出：會顯示 sample.docx 的檔案資訊

實作練習 1：轉換更豐富的內容

建立 report.md，輸入以下內容：

## 專案報告

### 摘要
這是一份使用 **Pandoc** 轉換的測試報告。

### 重點項目
1. 第一點：學會安裝 Pandoc
2. 第二點：學會基本轉換
3. 第三點：學會樣式對應

### 結論
Pandoc 是一個*非常實用*的工具！

> 引用：「簡單的工具，強大的功能。」

然後執行：pandoc report.md -o report.docx

實作練習 2：表格轉換

建立 table.md，輸入以下內容：

# 表格測試

| 項目 | 說明 | 價格 |
|------|------|------|
| 蘋果 | 紅色水果 | $30 |
| 香蕉 | 黃色水果 | $20 |
| 橘子 | 橙色水果 | $25 |

執行轉換：

pandoc table.md -o table.docx

觀察：Markdown 表格會轉換成 Word 表格！

進階：一次轉換多種格式

Pandoc 可以輸出多種格式，只要改副檔名：

# 轉成 Word
pandoc sample.md -o sample.docx

# 轉成 HTML
pandoc sample.md -o sample.html

# 轉成 PDF（需要額外安裝）
pandoc sample.md -o sample.pdf

注意：PDF 轉換需要額外安裝 LaTeX，本課程專注在 Word 轉換

進階：讓 AI 幫你執行

你可以在 Antigravity 的 AI 面板中這樣說：

範例 1：

請幫我把 sample.md 轉換成 Word 檔案

範例 2：

執行 pandoc sample.md -o sample.docx

AI 會幫你：在終端機中執行對應的 Pandoc 指令！

隨堂測驗 1

問題：在 Markdown 中，# 標題 會轉換成 Word 的什麼樣式？

內文 (Normal)
標題 1 (Heading 1)
標題 2 (Heading 2)
粗體 (Bold)

✅ 測驗 1 解答

答案：(2) 標題 1 (Heading 1)

對應關係：

# → 標題 1
## → 標題 2
### → 標題 3

隨堂測驗 2

問題：執行 Pandoc 轉換成功時，終端機會顯示什麼？

「轉換成功！」
「Success!」
什麼都不顯示
顯示轉換進度條

✅ 測驗 2 解答

答案：(3) 什麼都不顯示

解釋：這是 Unix 工具的傳統——「沒有消息就是好消息」。Pandoc 成功時不輸出任何訊息，只有發生錯誤時才會顯示錯誤訊息。

如何確認轉換成功？

📁

方法 1

查看檔案總管是否有新的 .docx 檔案

📄

方法 2

用 Word 開啟檔案確認內容

⌨️

方法 3

用 dir *.docx 指令確認

❌

失敗時

終端機會顯示紅色錯誤訊息

Unit 02 總結

✅

已學會

建立 Markdown 測試檔案
執行 pandoc 轉換指令
驗證轉換結果
Markdown → Word 對應關係

➡️

下一步

Unit 03：學習常見錯誤與解決方案！

恭喜！你已經成功完成第一次 Pandoc 轉換！