你剛發現 Markdown 這個東西，每個人都說它「很簡單」，但你盯著那些星號、井字號和括號，完全不知道從何下手。
同事隨口提到他所有文件都用 Markdown 寫。你喜歡的技術部落格用它。GitHub 上到處都是 README 檔案。但當你試著自己學習時，那些文件讓人頭昏腦脹，教學又假設你已經懂了一半。
我想告訴你一個事實：Markdown 確實很簡單——只是需要有人用不廢話的方式教你重點。
這篇速查表會成為你最常開啟的書籤。我會告訴你確切需要知道的內容：視覺化範例、對照比較，以及一份可以永久保存的參考指南。沒有廢話，沒有複雜的邊緣案例——只有每天都會用到的實用語法。
讓我們用接下來的 10 分鐘，讓你成為有自信的 Markdown 使用者。
什麼是 Markdown（以及為什麼你該在意）
Markdown 是可以轉換成 HTML 的純文字格式。就這麼簡單。
你用簡單的符號寫，像是 **粗體**，它就會轉換成 粗體。不需要按鈕、不需要工具列、不需要專門的軟體。
初學者會愛上它的理由：
到處都能用：GitHub 的 README 檔案用它、Reddit 的留言用它、Discord、Notion、Stack Overflow、Jupyter Notebooks、無數部落格——全都支援 Markdown。學一次，到處寫。
永不過時：Markdown 檔案就是純文字。50 年後，在任何裝置、任何作業系統上都能開啟。試試看開啟一個 1995 年的 Word 檔案——祝你好運。你的 Markdown 檔案？永遠都能用。
可攜性強：從 Notion 複製文字，貼到 GitHub，搬到你的部落格。Markdown 到處移動都不會壞掉。不會有「格式跑掉」的惡夢。
你其實已經會基礎：有沒有在聊天室裡用 *星號* 框住文字來強調過？那就是 Markdown 的思維。你比想像中更接近了。
快速上手的秘訣：只要學七個語法規則，就能處理 90% 的格式需求。七個。比記 Word 的快捷鍵還少。
準備好了嗎？我們來學這七個規則。
每天都會用到的 7 個 Markdown 語法規則
掌握這七個格式規則，你就能處理 90% 的寫作需求。每個只要 30 秒學會。我會告訴你語法、轉換後的樣子，以及什麼時候用。
1. 粗體和斜體文字
語法：
**粗體文字**
*斜體文字*
***粗體加斜體***
轉換結果：
- 粗體文字
- 斜體文字
- 粗體加斜體
何時使用：粗體用來吸引注意重點。斜體用來增加細微的強調。想像粗體是大聲說話，斜體是湊近耳邊輕聲說。
💡 專業建議：用
**雙星號**表示粗體，*單星號*表示斜體。有些人用底線（__粗體__或_斜體_），但星號更常見，而且到處都能用。
常見錯誤：在星號裡面加空格會破壞格式。** 文字 ** 不會有用。要緊貼：**文字**。
2. 標題（建立結構）
語法：
# 標題 1（文件標題）
## 標題 2（主要段落）
### 標題 3（次要段落）
#### 標題 4（小段落）
經驗法則：用一個 # 當文件標題，## 當主要段落，### 當段落中的小節。大多數文件不需要超過三層標題。
結構範例：
# 我的專案文件
## 開始使用
### 安裝步驟
### 設定方式
## 進階用法
### API 參考
### 疑難排解
⚠️ 常見錯誤：不要跳級。從
##直接跳到####會讓讀者困惑，也破壞導覽結構。永遠按順序來。
為什麼重要：標題是文件的骨架。它們幫助讀者掃描、跳到需要的段落，一眼理解你的結構。
3. 清單（項目符號和編號）
語法：
- 項目符號
- 另一個項目
- 第三個項目
1. 第一項
2. 第二項
3. 第三項
巢狀清單，縮排 2 個空格：
- 主要項目
- 巢狀項目
- 另一個巢狀項目
- 回到主層級
1. 第一步
- 第一步的細節
- 另一個細節
2. 第二步
轉換結果：
- 主要項目
- 巢狀項目
- 另一個巢狀項目
- 回到主層級
💡 小技巧：你可以用
-、*或+來做項目符號——都能用。堅持用-比較一致（這是最常見的慣例）。
另一個技巧：編號清單可以每項都用 1.，Markdown 會自動編號。這讓重新排序變簡單：
1. 第一項
1. 第二項
1. 第三項
仍然會顯示為 1、2、3。
4. 連結
語法：
[連結文字](網址)
實際範例：
[Google](<https://google.com>)
[我的 GitHub](<https://github.com/leonwong282>)
[聯絡我]([mailto:你的@email.com](mailto:你的@email.com))
最佳實踐：使用描述性的連結文字，告訴讀者要去哪裡。不要這樣做：
❌ 點擊[這裡](網址)查看文件
改成這樣：
✅ 閱讀 [Python 官方文件](網址)了解細節
為什麼？對無障礙功能更好（螢幕閱讀器），對 SEO 更好，對掃描內容的讀者更有幫助。
💡 電子郵件連結：在網址裡用
mailto:來建立可點擊的電子郵件連結：[聯絡我]([mailto:你的@email.com](mailto:你的@email.com))
5. 圖片
語法：
實際範例：
關鍵差異：開頭的 ! 驚嘆號讓它變成圖片。沒有它，就只是普通連結。
= 顯示圖片[文字](網址)= 建立可點擊的連結
替代文字很重要：[ ] 裡面的文字就是你的替代文字。它會在圖片載入失敗時顯示，也幫助使用螢幕閱讀器的視障讀者。永遠寫描述性的替代文字。
好的：![終端機顯示 npm install 指令的截圖]
不好的：![圖片1] 或 ![照片]
6. 程式碼（行內和區塊）
這是 Markdown 在技術寫作上真正發光的地方。
行內程式碼（短片段）：
使用 `print()` 函式來顯示輸出。
變數 `user_id` 儲存 ID。
執行 `npm install` 來安裝相依套件。
顯示為：使用 print() 函式來顯示輸出。
程式碼區塊（多行程式碼）：
def hello_world():
print("Hello, World!")
💡 語言高亮：在開頭的三個反引號後面加上語言名稱，就能有語法高亮。常見選項：
python、javascript、java、sql、bash、html、css、json
JavaScript 範例：
const greeting = (name) => {
console.log(`Hello, ${name}!`);
};
語言標識符會給你漂亮的彩色語法高亮。
7. 引用區塊
語法：
> 這是引用或重點提示。
> 可以跨越多行。
顯示為：
這是引用或重點提示。
可以跨越多行。
引用區塊用於：
- 來源的實際引文
- 重要的提示或警告
- 強調關鍵重點
- 需要強調的備註或提示
巢狀引用：
> 外層引用
>> 巢狀引用
>>> 深層巢狀
大多數人很少巢狀引用，但需要時可以用。
初學者最常犯的 5 個錯誤（立刻修正）
我教過數百人 Markdown。這五個錯誤每次都會出現。現在學會它們，省下數小時的挫折。
錯誤 #1：忘記空行
問題：沒有在段落和段落之間加空行時，它們會黏在一起。
範例：
❌ 錯誤：
## 標題
文字直接在這裡開始。
下一行的更多文字。
✅ 正確：
## 標題
文字在空行後開始。
另一個空行後的新段落。
為什麼會這樣：在純文字中，按一次 Enter 只是繼續段落。Markdown 需要那個空行來知道你要新段落或段落。
解決方法：永遠在標題前後、段落之間，以及清單、程式碼區塊和引用區塊周圍加空行。
錯誤 #2：粗體/斜體語法中的空格
問題：在星號裡面放空格會破壞格式。
❌ 錯誤：** 文字 ** 或 * 文字 *
✅ 正確：**文字** 或 *文字*
會發生什麼：Markdown 看到空格會以為你不是要格式化——它會直接顯示星號： 文字
解決方法：讓格式標記緊貼文字。星號和要格式化的文字之間不要有空格。
錯誤 #3：圖片忘記 !
問題：寫 [圖片](網址) 會建立圖片的連結，不是嵌入圖片。
❌ 連結（不是你要的）：[Logo](logo.png) → Logo
✅ 圖片（嵌入）： → 顯示實際圖片
為什麼會這樣：連結和圖片的語法幾乎一模一樣。那一個小小的 ! 造成所有差異。
記憶訣竅：驚嘆號是你在驚嘆「看這張圖！」
錯誤 #4：清單縮排不一致
問題：因為不當的縮排，巢狀清單會壞掉或看起來很怪。
❌ 錯誤（只有 1 個空格）：
- 主項目
- 巢狀（可能無法正確顯示）
✅ 正確（2 個空格或 1 個 tab）：
- 主項目
- 巢狀（乾淨的縮排）
- 另一個巢狀
- 回到主層級
解決方法：巢狀項目永遠縮排 2 個空格（或 4 個空格，或 1 個 tab——保持一致）。1 個空格太少，很多平台上會破壞顯示。
錯誤 #5：不跨平台測試
問題：你的 Markdown 在編輯器裡看起來完美，但在 GitHub 或 Medium 上就壞了。
為什麼會這樣：不同平台使用不同的 Markdown「風格」——支援的內容有些微差異。
解決方法：
- 發布前先預覽你的 Markdown（大多數編輯器都有預覽模式）
- 在目標平台上測試（在預備環境寫，發布前先預覽）
- 有疑問時，堅持用基本 7 招——它們到處都能用
寫 Markdown 的必備工具
這些免費工具會讓你的 Markdown 工作流程快 10 倍。我每天都在用——它們會省下你的時間和挫折。
最佳 Markdown 編輯器
Typora（Mac/Windows/Linux）
- 特色：所見即所得編輯器——打字時就看到格式化的文字
- 免費/付費：有試用版，一次性購買
VS Code（所有平台）
- 特色：免費、強大、內建預覽（Ctrl+Shift+V）
- 免費/付費：完全免費
Dillinger（線上）
- 特色：不需安裝，任何瀏覽器都能用
- 免費/付費：免費
Notion（所有平台 + 網頁）
- 特色：結合 Markdown 快捷鍵和豐富功能
- 免費/付費：有免費方案
自己試試看：5 分鐘挑戰
準備好測試你的新技能了嗎？完成這個挑戰，你就知道自己已經掌握基礎了。
你的挑戰
- 開啟編輯器：前往 Dillinger.io（不需註冊）
- 建立一份文件，包含：
- ✅ 一個 H1 標題（你的文件標題）
- ✅ 兩個 H2 標題（兩個主要段落）
- ✅ 至少一句話中有 粗體文字
- ✅ 至少一句話中有 斜體文字
- ✅ 一個有 3 個項目的項目符號清單
- ✅ 一個外部連結（到任何網站）
- ✅ 一個行內程式碼範例
- ✅ 一個有語言高亮的程式碼區塊
範例挑戰解答
可能看起來像這樣：
# 我的第一份 Markdown 文件
## 介紹
這是我**第一次**嘗試 Markdown，我*已經*掌握訣竅了！
我學到的東西：
- Markdown 很簡單
- 到處都能用
- 我可以用它來寫 `程式碼` 範例
## 程式碼範例
這是一個 Python 函式：
```python
def greet(name):
return f"你好，{name}！"
```
看看 [Markdown 指南]([<https://www.markdownguide.org>)！](<https://www.markdownguide.org>)！)
現在設定 5 分鐘計時器試試看。如果你能在不回頭看語法的情況下建立這份文件，你就掌握基礎了。真的——把這篇文章放一邊，自己測試看看。
你會創造什麼？
Markdown 的美在於它的簡單性。不需要複雜的軟體。不需要授權。不會有格式頭痛。只有你、純文字，以及隨時隨地在任何裝置上寫作的能力。
你現在是 Markdown 社群的一員了——數百萬選擇簡單性和可攜性而非專有工具的開發者、作家和創作者。
在下面留言：你會用 Markdown 寫的第一個東西是什麼？README？筆記？文件？我會讀每一則留言，很喜歡看到大家創造的東西！
覺得有幫助嗎？分享給正在學 Markdown 的人。把這頁加入書籤以便將來參考。需要快速查語法時隨時回來看。
快樂寫作！ 🚀
想看更多初學者友善的教學？追蹤我，我會分享 GitHub、網頁開發和讓生活更輕鬆的生產力工具指南。
