---
title: Markdown 新手完整指南 — 從零到 AI 時代，一篇就搞懂
date: 2026-04-20
tags: [markdown, 教學, 新手入門, AI, 知識管理]
description: 完全沒接觸過 Markdown？這篇從「是什麼」講到「為什麼連 AI 都愛它」。不用 15 分鐘，你就能寫出第一篇 Markdown 文件。
cover: markdown-主視覺.jpg
---
# Markdown 新手完整指南 — 從零到 AI 時代，一篇就搞懂
## 等一下，這是什麼？為什麼我的朋友都在用？
有沒有發生過這種事：
你打開朋友傳來的檔案，副檔名是怪怪的 `.md`。用 Word 打開，亂碼；用記事本打開，看到滿滿的 `#`、`**`、`-`，像某種密碼。你關上檔案，心想「這不是我的世界」。
但你後來又發現，GitHub 上每個專案都有個 `README.md`；你用 ChatGPT 或 Claude 問問題，它的回答總是整整齊齊有標題有清單；你朋友的 Obsidian 筆記軟體裡，每個檔案都是 `.md`。
這個神秘的東西叫 **Markdown**。而且老實說，它比你想像的簡單太多了，**真的只要 15 分鐘就能學會**。
這篇文章會帶你從零開始。沒有術語轟炸，每個概念都有例子。讀完之後，你不只會寫 Markdown，還會懂為什麼 2026 年的 AI 工具幾乎全都用它當預設輸出格式。
---
## Markdown 是什麼？用白話解釋
想像一下，你在紙上寫筆記。你會怎麼標示「這是標題」？
大部分人會**畫底線**、**寫大一點**，或者**在前面加一個圓點**。這些動作背後有個邏輯：用最小的符號傳達最大的意思。
Markdown 就是把這個邏輯搬到電腦上。它是一種**輕量級標記語言（lightweight markup language）**，由 John Gruber 和 Aaron Swartz 在 [2004 年發明](https://en.wikipedia.org/wiki/Markdown) ，核心哲學就一句話：
> 讓純文字看起來就像「已經被格式化過」，而且任何人不需要學習就能看懂。
舉個例子。同一段內容，三種寫法：
**HTML 寫法**（網頁用的）：
```html
<h1>今天的待辦</h1>
<ul>
<li>買牛奶</li>
<li><strong>打電話給媽媽</strong></li>
</ul>
```
**Word 檔**：一個你打不開原始碼的二進位檔，只能用特定軟體編輯。
**Markdown 寫法**：
```markdown
# 今天的待辦
- 買牛奶
- **打電話給媽媽**
```
哪個看起來比較舒服？哪個不用軟體就看得懂？
這就是 Markdown 的魔法。它是「**純文字**」（plain text），意思是你用任何編輯器都能打開，二十年後也不會失效。但它又透過幾個簡單符號（`#`、`*`、`-`）加上了「結構感」，可以被轉換成漂亮的網頁、PDF、甚至投影片。
---
## 為什麼要學？Word 不好嗎？
我知道你在想什麼：「我已經會用 Word 了，為什麼要學新東西？」
這是個好問題。讓我直接給你三個 Word 解決不了、但 Markdown 輕鬆搞定的場景。
### 場景一：半年後，你打不開自己的檔案
你有沒有過這種經驗：打開三年前的 Word 檔，排版全亂掉？或者用新版 Word 開舊檔，字型跑位？
Word 的檔案格式（`.docx`）是**二進位格式**，需要特定軟體（通常還要付費）才能解讀。軟體升級、格式改變，舊檔就可能出事。
Markdown 是**純文字**，底層用的是 UTF-8 編碼，**向後相容到 1963 年的 ASCII**。你現在寫的 `.md` 檔案，20 年後用任何一個文字編輯器都還是打得開。
### 場景二：`final_v3_真的_ACTUAL_FINAL.docx`
你一定看過這種檔名吧。
Word 檔案因為是二進位格式，**沒辦法用 Git 做版本控制**。每次改動都是「整個檔案變了」，你無法看到「我昨天改了哪一句話」。
Markdown 是純文字，完美契合 Git。我改了一個字、加了一行、刪了一個段落，Git 都能精準顯示。[ModernActuary 的技術部落格](https://modernactuary.co.za/journal/version-controlling-docx) 有篇文章講得很好：「用 Markdown + Git，你永遠會有一個明確的最新版本，每次改動都有紀錄，誰改的、什麼時候改的、為什麼改，都一清二楚。」
### 場景三：你想要的，Word 永遠給不了的自由
Word 有個本質問題：**內容和樣式綁在一起**。你在 Word 裡寫的東西，離開 Word 就變形。
Markdown 反過來 — **內容是內容，樣式是樣式，完全分離**。同一份 `.md` 檔案，你可以透過工具變成：
- 網頁（HTML）
- PDF 文件
- Word 檔（需要給不會用 Markdown 的人）
- 投影片（reveal.js）
- 電子書（ePub）
- 靜態網站（Jekyll、Hugo、Hexo）
一份來源，多種產出。這就是專業寫作者、工程師、研究者越來越愛用 Markdown 的原因。[哈佛學者 Stuart Shieber 甚至寫過一篇專文](http://blogs.law.harvard.edu/pamphlet/files/2014/08/markdownpost-acmsmall.pdf) ，直接叫「為什麼學者應該用 Markdown 寫論文」。
---
## 10 分鐘學會：Markdown 基本語法
好，夠多理論了。來動手吧。
你現在只需要一個地方「寫東西」。最快的方法：打開瀏覽器，到 [stackedit.io](https://stackedit.io/) 或 [dillinger.io](https://dillinger.io/) ，左邊打字，右邊即時看到結果。
準備好了嗎？接下來是你這輩子唯一需要的 Markdown 速查表。
### 標題：用 `#` 的數量決定大小
```markdown
# 這是最大的標題（H1）
## 第二大標題（H2）
### 第三大標題（H3）
#### 第四大標題
##### 第五大標題
###### 最小的標題
```
**新手第一個坑**：`#` 後面**一定要有空格**。寫 `#標題` 不會變成標題，寫 `# 標題` 才會。
### 粗體、斜體、刪除線
```markdown
這是 **粗體**
這是 *斜體*
這是 ***粗斜體***
這是 ~~刪除線~~
```
記憶法：一顆星是斜體，兩顆星是粗體。就像喊話：「特別一點！」用一層，「超級重要！」用兩層。
### 清單：購物清單 or 流程步驟
無序清單（項目沒先後）：
```markdown
- 蘋果
- 香蕉
- 牛奶
- 低脂
- 全脂
```
有序清單（有先後順序）：
```markdown
1. 起床
2. 刷牙
3. 發現手機沒電
4. 充電再睡回去
```
**小技巧**：有序清單你全部寫 `1.` 也沒關係，Markdown 會自動幫你編號。這讓你之後插入新項目時不用重新排。
待辦清單（大家最愛）：
```markdown
- [ ] 買牛奶
- [x] 打電話給媽媽
- [ ] 寫週報
```
### 連結和圖片
兩個語法長得很像，只差一個驚嘆號：
```markdown
連結：[顯示的文字](https://網址.com)
圖片：
```
例子：
```markdown
我每天必看 [Hacker News](https://news.ycombinator.com)。
```
### 程式碼：單行和多行
行內程式碼（一個反引號）：
```markdown
要安裝請執行 `npm install`
```
多行程式碼區塊（三個反引號，可以指定語言讓它有語法高亮）：
````markdown
```python
def hello():
print("Hello, Markdown!")
```
````
### 引用：擷取別人說的話
```markdown
> 純文字是所有格式的起點和終點。
> — Wired 雜誌，論 Markdown
```
### 表格：簡單資料整理
```markdown
| 工具 | 價格 | 適合誰 |
| --- | --- | --- |
| Obsidian | 免費（個人）| 重度知識管理 |
| HackMD | 免費起步 | 團隊協作 |
| VSCode | 免費 | 開發者 |
```
**坑預警**：表格的語法稍微囉嗦，但大多數編輯器（Obsidian、Typora）都有表格快捷鍵，不需要手打。
### 分隔線
三個減號、星號或底線都可以：
```markdown
---
```
### HTML 備案：當 Markdown 不夠用時
這招很少新手知道：**Markdown 可以混寫 HTML**。比如你要讓圖片置中、改變尺寸：
```markdown
<img src="cat.jpg" width="300" align="center">
```
完全合法。Markdown 不是一個封閉系統，它和 HTML 和諧共處。
---
## 新手最常踩的 5 個坑
寫了幾年 Markdown，我見過太多人卡在同樣的地方。先把這些記下來，省你幾小時的鬱悶時間。
**第一坑：`#` 後面忘記加空格**
`#標題` ❌ 不會變標題
`# 標題` ✅ 正確
**第二坑：換行不換行**
你在 Markdown 裡按一次 Enter，有些渲染器會當作「同一個段落」，不換行。想要真正換行，**按兩次 Enter**（留一個空白行）。
**第三坑：清單項目間不要亂空行**
```markdown
- 項目一
- 項目二
```
中間空行，有些編輯器會視為兩個獨立清單。除非你要故意分開，不然連續寫就好。
**第四坑：表格對齊要用冒號**
```markdown
| 左對齊 | 置中 | 右對齊 |
| :--- | :---: | ---: |
```
分隔列的冒號位置決定對齊方向。
**第五坑：Obsidian、GitHub、HackMD 的語法有細微差異**
這是 Markdown 生態最大的缺點：各家有各家的「flavor（口味）」。最常見的是 GitHub Flavored Markdown (GFM)，支援表格、待辦清單、程式碼語法高亮等。遇到特殊功能不相容時，不要慌，那是正常的。想了解標準化努力，可以看 [CommonMark](https://commonmark.org/) 這個專案。
---
## 工具推薦：我該用哪一個？
市面上的 Markdown 編輯器多到你眼花。我幫你整理成四類場景，直接對號入座。
### 場景一：我要做個人知識管理（第二大腦）
**首選：[Obsidian](https://obsidian.md/)**
- **免費**（個人使用）
- 所有筆記是本機 `.md` 檔，**你完全擁有資料**
- 強大的雙向連結（`[[筆記名]]`）打造知識網絡
- 1000+ 社群外掛
- 內建 AI 整合越來越強，2026 年成為「第二大腦」的主流選擇
我自己就是重度 Obsidian 使用者。推薦理由：20 年後這些 `.md` 檔你都還打得開，Obsidian 倒了也沒差。
### 場景二：我要和團隊即時協作
**首選：[HackMD](https://hackmd.io/)**
- 雲端即時協作，像 Google Docs 但是 Markdown 版
- 會議筆記、團隊文件、技術分享的神器
- 可以直接發布成簡報（reveal.js）
- 免費帳號就很夠用
### 場景三：我是寫程式的
**首選：[VSCode](https://code.visualstudio.com/) + Markdown 外掛**
- 原生支援 Markdown 預覽（`Ctrl/Cmd + Shift + V`）
- 裝 Markdown All in One 外掛後體驗大升級
- 可以同時管理程式碼和文件
### 場景四：我只想要一個乾淨的寫作環境
**首選：[Typora](https://typora.io/)**（付費，一次買斷）
- 所見即所得（WYSIWYG）的 Markdown 編輯器
- 你打 `**粗體**` 它會直接顯示成粗體，符號自動隱藏
- 適合討厭看到「原始語法」的人
**備用：StackEdit、Dillinger**（網頁版，免費，不用安裝）
---
## 為什麼 2026 年，連 AI 都愛 Markdown？
這是這篇文章最有意思的部分。
如果你觀察 ChatGPT、Claude、Gemini 的回答，會發現它們**預設都用 Markdown 格式輸出**。這不是巧合，是一個根本性的技術選擇。
### 原因一：Token 經濟學 — Markdown 比 HTML 省 40-80%
LLM（大型語言模型）以 token 計費。token 簡單講就是「字的小單位」。格式化符號越多，花的 token 越多。
同樣一段有結構的內容，[Cloudflare 實測](https://blog.cloudflare.com/introducing-markdown-for-agents/) 從 HTML 轉成 Markdown，**token 從 16,180 降到 3,150，省了 80%**。有些複雜頁面甚至可以省 95%。
對 AI 公司來說，這是真金白銀的成本差異。
### 原因二：訓練資料 — LLM 早就「吃」了幾十億份 Markdown
GitHub 上幾乎每個 repo 都有 `README.md`。React、Kubernetes、Python 的文件站幾乎都是 Markdown 寫的。Stack Overflow、Reddit 的格式底層也是 Markdown。
**結論**：LLM 在訓練時讀了數十億份 Markdown 文件。對它來說，輸出 Markdown 就像「回到母語」。
### 原因三：「Markdown is the new API」
這是 2026 年最熱的軟體架構趨勢。
根據 [The New Stack 的一篇分析](https://thenewstack.io/skills-vs-mcp-agent-architecture/) ，創投家 Brad Feld 用 **12 個 Markdown 檔案（叫做 CompanyOS）** 經營整間公司 — 每個檔案教 Claude Code 怎麼處理特定任務（寫郵件、客服、準備董事會資料）。沒有複雜的後端系統，就是 `.md` 檔 + Git。
更驚人的數字對比：
- GitHub 官方的 MCP 伺服器：教 AI 怎麼用 GitHub，要花 **50,000 個 token**
- 一份 `SKILL.md` 檔：寫「用 gh CLI 執行這些操作」，只要 **200 個 token**
**相同效果，250 倍效率**。這就是為什麼越來越多開發者相信：**未來的 AI 指令、工作流、公司流程，都會以 Markdown 為載體**。
### 原因四：你的筆記 = AI 的脈絡
2025 到 2026 年，有個新的工作流在知識工作者之間爆紅：
**把 Obsidian vault 當作 AI 的「持久記憶」**
你平常用 Obsidian 記筆記（純 Markdown 檔）。需要 AI 幫忙時，不用每次重新解釋你的背景、專案、偏好 — AI 直接讀你的 vault，知道你是誰、在做什麼。
這個架構叫 **Claude Code + MCP-Obsidian**，相關工具如 [smithery-ai/mcp-obsidian](https://github.com/smithery-ai/mcp-servers) 在 GitHub 上星星數量快速成長。[筆記 app 市場規模預計從 2023 年的 5.76 億成長到 2032 年的 22.6 億美元](https://latenode.com) ，年複合成長率 16.4%。
**一句話總結**：你用 Word 寫的東西，AI 看不懂。你用 Markdown 寫的東西，AI 天生就懂。
---
## 新手常見問題 FAQ
**Q1：我的 `.md` 檔要用什麼打開？**
任何文字編輯器都可以（記事本、VSCode、Sublime Text）。但要看「渲染後」的樣子，用 Obsidian、Typora、VSCode（`Cmd+Shift+V` 預覽）、或網頁版 StackEdit。
**Q2：Markdown 有辦法打出數學公式嗎？**
可以，用 LaTeX 語法包在 `$...$`（行內）或 `$$...$$`（區塊）。但需要支援的渲染器（Obsidian、HackMD、GitHub Issues 等）。
**Q3：我寫好的 Markdown 要怎麼變成 Word 檔給長輩看？**
推薦工具 [Pandoc](https://pandoc.org/) 。安裝後執行：
```bash
pandoc input.md -o output.docx
```
一鍵轉 Word、PDF、ePub 都行。
**Q4：能不能同時用 Markdown 和 Word？**
完全可以。很多專業寫作者的工作流是：
1. 用 Markdown 寫初稿（Obsidian 或 Typora）
2. 用 Pandoc 轉 Word 給編輯或客戶
3. 客戶用 Word track changes 回饋
4. 手動把修改合回 Markdown（或直接接受 Word 版成品）
**Q5：Markdown 能做複雜排版（多欄、頁碼、目錄）嗎？**
基本的可以（目錄、腳註），複雜的不行。如果需要精準排版，建議用 LaTeX 或 Typst。但老實說，90% 的人一輩子不會需要這些。
**Q6：手機上能寫 Markdown 嗎？**
可以。Obsidian 有 iOS / Android app，1Writer、iA Writer 也都很棒。
**Q7：Markdown 會不會過時？**
[Wired 雜誌的這篇文章](https://www.wired.com/story/the-eternal-truth-of-markdown/) 標題叫「The Eternal Truth of Markdown」（Markdown 的永恆真理）。純文字從 1960 年代活到現在還沒死，Markdown 又站在 AI 浪潮最前線 — 短期內不用擔心這個問題。
---
## 結語：你的下一步
如果你讀到這裡，恭喜你 — 你已經知道 Markdown 的 80%。剩下的 20%，你會在實際使用中自然學會。
我給你一個具體的 30 天行動建議：
**第 1 週**：下載 Obsidian，用 Markdown 寫今天的日記。堅持 7 天。
**第 2 週**：把你腦中某個主題（興趣、工作筆記、學習紀錄）的內容用 Markdown 整理成幾個檔案。嘗試用 `[[雙向連結]]` 串起來。
**第 3 週**：開始在工作場合用 Markdown。跟團隊分享會議紀錄（HackMD）、給主管的週報（轉成 Word 給他）。
**第 4 週**：嘗試把你的 Markdown 筆記接上 AI。讓 Claude 或 ChatGPT 讀你的筆記，回答你的問題。感受那種「AI 理解你的脈絡」的震撼。
一個月後，你會忍不住跟朋友說：「**我以前怎麼會用 Word 用這麼久？**」
祝你寫作愉快。歡迎加入純文字的世界。
---
## 延伸閱讀
- [Markdown Guide 官方教學](https://www.markdownguide.org/) ：最完整的英文速查
- [CommonMark 標準規範](https://commonmark.org/) ：想搞懂「正統 Markdown」必讀
- [Obsidian 官方說明](https://help.obsidian.md/) ：第二大腦的起點
- [HackMD 使用手冊](https://hackmd.io/c/tutorials) ：團隊協作利器
- [Pandoc 官方文件](https://pandoc.org/) ：格式轉換之王
- [Why scholars should write in Markdown（Stuart Shieber）](http://blogs.law.harvard.edu/pamphlet/files/2014/08/markdownpost-acmsmall.pdf) ：學者視角的深度思考
- [The Eternal Truth of Markdown（Wired）](https://www.wired.com/story/the-eternal-truth-of-markdown/) ：為什麼純文字是永恆的
- [Skills vs MCP Agent Architecture（The New Stack）](https://thenewstack.io/skills-vs-mcp-agent-architecture/) ：AI 時代 Markdown 的新角色
- [Markdown for Agents（Cloudflare）](https://blog.cloudflare.com/introducing-markdown-for-agents/) ：網站為 AI 提供 Markdown 的未來
---
*這篇文章是我在 2026 年 4 月，研究後寫成的。所有數據、工具版本、趨勢觀察皆為當時最新資訊。如果你是五年後才看到這篇文章，歡迎告訴我哪些地方已經過時 — 但我打賭，核心概念還是適用的。畢竟，Markdown 活了 22 年了。*
Sign in via Google
Sign in via Facebook
Sign in via X(Twitter)
Sign in via GitHub
Sign in via Dropbox
Sign in with Wallet
Connect another wallet