Markdown 入門速查表：給完全新手的收藏指南

你剛發現 Markdown 這個東西，每個人都說它「很簡單」，但你盯著那些星號、井字號和括號，完全不知道從何下手。

我想告訴你一個事實：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. 圖片

語法：

![替代文字](圖片網址.jpg)

實際範例：

![金門大橋夕陽](<https://example.com/bridge.jpg>)

關鍵差異：開頭的 ! 驚嘆號讓它變成圖片。沒有它，就只是普通連結。

• ![文字](網址) = 顯示圖片
• [文字](網址) = 建立可點擊的連結

替代文字很重要：[ ] 裡面的文字就是你的替代文字。它會在圖片載入失敗時顯示，也幫助使用螢幕閱讀器的視障讀者。永遠寫描述性的替代文字。

好的：![終端機顯示 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

✅ 圖片（嵌入）：![Logo](logo.png) → 顯示實際圖片

為什麼會這樣：連結和圖片的語法幾乎一模一樣。那一個小小的 ! 造成所有差異。

記憶訣竅：驚嘆號是你在驚嘆「看這張圖！」

錯誤 #4：清單縮排不一致

問題：因為不當的縮排，巢狀清單會壞掉或看起來很怪。

❌ 錯誤（只有 1 個空格）：

- 主項目
 - 巢狀（可能無法正確顯示）

✅ 正確（2 個空格或 1 個 tab）：

- 主項目
  - 巢狀（乾淨的縮排）
  - 另一個巢狀
- 回到主層級

解決方法：巢狀項目永遠縮排 2 個空格（或 4 個空格，或 1 個 tab——保持一致）。1 個空格太少，很多平台上會破壞顯示。

錯誤 #5：不跨平台測試

問題：你的 Markdown 在編輯器裡看起來完美，但在 GitHub 或 Medium 上就壞了。

為什麼會這樣：不同平台使用不同的 Markdown「風格」——支援的內容有些微差異。

解決方法：

1. 發布前先預覽你的 Markdown（大多數編輯器都有預覽模式）
2. 在目標平台上測試（在預備環境寫，發布前先預覽）
3. 有疑問時，堅持用基本 7 招——它們到處都能用

💡 專業建議：使用像 Dillinger 或 StackEdit 這樣的線上編輯器，可以在學習時看到即時預覽。

寫 Markdown 的必備工具

這些免費工具會讓你的 Markdown 工作流程快 10 倍。我每天都在用——它們會省下你的時間和挫折。

最佳 Markdown 編輯器

Typora（Mac/Windows/Linux）

• 特色：所見即所得編輯器——打字時就看到格式化的文字
• 免費/付費：有試用版，一次性購買

VS Code（所有平台）

• 特色：免費、強大、內建預覽（Ctrl+Shift+V）
• 免費/付費：完全免費

Dillinger（線上）

• 特色：不需安裝，任何瀏覽器都能用
• 免費/付費：免費

Notion（所有平台 + 網頁）

• 特色：結合 Markdown 快捷鍵和豐富功能
• 免費/付費：有免費方案

自己試試看：5 分鐘挑戰

準備好測試你的新技能了嗎？完成這個挑戰，你就知道自己已經掌握基礎了。

你的挑戰

1. 開啟編輯器：前往 Dillinger.io（不需註冊）
2. 建立一份文件，包含：
3. • ✅ 一個 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、網頁開發和讓生活更輕鬆的生產力工具指南。