Markdown 語法速查表

Markdown 語法速查表,涵蓋標題、粗體、斜體、連結、圖片、程式碼區塊、表格等完整語法。一鍵複製範例程式碼,快速上手 Markdown 寫作。

立即使用Markdown 語法速查表(免費、免註冊)

這張速查表把 Markdown 語法分成標題、文字格式、列表、連結與圖片、程式碼、引用與分隔、表格、進階語法幾大類,每條旁邊寫著會變成哪個 HTML 標籤或什麼效果,按複製鈕就能貼進文件;最上面還有最常用語法的快速按鈕,點一下就複製。只有部分平台看得懂的語法會特別標出來,下面也實測了它們在本站 Markdown 工具裡的結果。

怎麼查最快

  • 快速參考按鈕:頁面最上方的按鈕點一下就複製;「```區塊```」會複製成可以直接用的三行程式碼區塊,「| 表格 |」會複製成含表頭與分隔列的完整兩欄表格。
  • 分類分頁:預設「全部」一次列完;點上方的分類只看那一類,語法與結果會並排顯示,旁邊有「複製」按鈕。手機上「全部」只列語法,想看結果請點分類分頁。
  • 標籤:標「GitHub 風格」的是 GitHub 擴充規格(GFM)才有的寫法(刪除線、任務清單),支援 GFM 的地方都看得懂;標「部分平台支援」的,很多地方不認得,用之前先確認你的平台。

每條語法都是純文字範例,複製後把「標題文字」「連結文字」這些字換成自己的內容即可。速查表本身不做即時預覽;想馬上看效果,把語法貼到站上的 Markdown 預覽器,右邊會即時畫出來。

「部分平台支援」的語法在本站會變成什麼

丟進站上的 Markdown 工具實測
語法本站結果
高亮照原文顯示
下標變成刪除線
上標照原文顯示
腳註變成連結
定義列表照原文顯示
縮寫照原文顯示

本站的 Markdown 預覽器、編輯器、轉 HTML、轉 PDF 用同一套 GitHub 風格規則;別的平台可能支援其中幾種。

下標:不是照原文顯示,而是變成別的東西

H~2~O
→ <p>H<del>2</del>O</p>

腳註:不是照原文顯示,而是變成別的東西

文字[^1]

[^1]: 腳註內容
→ <p>文字<a href="%E8%85%B3%E8%A8%BB%E5%85%A7%E5%AE%B9">^1</a></p>

下標用單一波浪號 ~ 包起來,在 GitHub 風格的規則裡會被當成刪除線;要寫化學式,比較保險的做法是直接寫 HTML:H<sub>2</sub>O。

寫錯最常見的幾個地方

以下每一條都是實際轉換的結果(→ 後面是轉出來的 HTML):

# 後面沒空格:不是標題

#標題
→ <p>#標題</p>

清單符號後面沒空格:不是清單

-項目
→ <p>-項目</p>

子項目只縮 1 格:變成同一層

- 項目
 - 子項目
→ <ul>
<li>項目</li>
<li>子項目</li>
</ul>

縮 2 格:才是下一層

- 項目
  - 子項目
→ <ul>
<li>項目<ul>
<li>子項目</li>
</ul>
</li>
</ul>

少了 | --- | 分隔列:不是表格

| 名稱 | 數量 |
| 蘋果 | 3 |
→ <p>| 名稱 | 數量 |
| 蘋果 | 3 |</p>

符號前加 \ 就照字面顯示

\*不是斜體\*
→ <p>*不是斜體*</p>

換行也是常見問題:同一段裡只按一次 Enter 不會換行,要在行尾加兩個空白,或空一行分段。程式碼區塊則要在前後各放一行三個反引號 ```,結尾那行忘了寫,後面整份文件都會變成程式碼。開頭的 ``` 後面寫語言名稱(例如 javascript、python),站上的 Markdown 預覽器、編輯器與轉 HTML 會依語言上色;名稱拼錯或不認得就不上色,但仍然是程式碼區塊。

中文裡用 * 不要用 _

底線包住、前後緊接中文:不會變斜體

這是_斜體_文字
→ <p>這是_斜體_文字</p>

改用星號:正常變斜體

這是*斜體*文字
→ <p>這是<em>斜體</em>文字</p>

速查表裡 ** 與 __、* 與 _ 列成兩種寫法,在英文句子裡效果相同;但底線夾在文字中間時(例如 snake_case 或前後都是中文),規則會把它當成一般符號。中文文件建議一律用星號。粗體包住「」這類全形標點又緊接中文時,也可能失效,在星號外側各加一個空白就好。

Markdown 語法速查表功能特點

  • 常用語法參考(標題、格式、清單、連結圖片、程式碼、引用、表格、進階)
  • 每個語法附對應的 HTML 或效果說明
  • 一鍵複製範例
  • 分類整理
  • 標出只有部分平台支援的語法

如何使用Markdown 語法速查表?

  1. 瀏覽各分類語法
  2. 對照語法與對應的 HTML/效果說明
  3. 點擊複製按鈕使用

Markdown 語法速查表常見問題

Markdown 難學嗎?

不難。常用的只有標題 #、粗體 **、清單 -、連結 [文字](網址) 幾種符號,照這頁的範例複製、改字就能開始寫,其他語法用到再查。

哪些平台支援 Markdown?

GitHub、GitLab 等程式碼平台,以及多數筆記軟體、部落格系統、技術文件工具都支援;各平台支援的進階語法不同,表格、任務清單這類擴充語法用之前先確認。

Markdown 有哪些進階語法?

進階語法包括表格、任務清單、腳註、定義列表、數學公式(LaTeX)、Mermaid 圖表等。不同平台支援的進階語法可能有所不同。

如何在 Markdown 中插入圖片?

使用 ![替代文字](圖片網址) 語法即可插入圖片。也可以使用 HTML 的 img 標籤來獲得更多控制,例如調整圖片大小和對齊方式。

Markdown 怎麼換行?

在同一段裡換行:行尾加兩個半形空白再按 Enter(會變成 <br>)。要分成新段落:中間空一行。只按一次 Enter 在大多數平台會接在同一行。

Markdown 的粗體為什麼沒有作用?

最常見的原因是星號緊貼全形標點又接著中文,例如「這是**「重點」**文字」。在星號外側各加一個空白(這是 **「重點」** 文字)就會正常。另外 ** 和文字之間不能有空白:** 粗體 ** 不會變粗。

Markdown 要怎麼打出 * 或 # 符號本身?

在符號前面加一個反斜線 \,例如 \*、\#、\_,就會照字面顯示、不會變成格式。放在反引號 ` 裡的行內程式碼也會原樣顯示。

Markdown 表格怎麼設定靠右或置中?

在第二列的分隔線加冒號::--- 靠左、:---: 置中、---: 靠右。速查表的「表格」分類有三種寫法可以直接複製;要從 Excel 轉表格,用站上的 Markdown 表格產生器比較快。