Markdown 語法速查表：語法參考與範例

本速查表完整列出所有常見的 Markdown 語法元素，每一項都附上簡明易懂的一句說明，以及可以直接複製使用的程式碼範例，方便隨時查閱。

標題、段落與換行

標題使用一到六個 # 字元加上一個空格；# 越少代表標題越大。空白行會開始新的段落。若要在段落內強制換行，可在行尾加上兩個空格或一個反斜線。

# Heading 1
### Heading 3

A paragraph.
Line break with two trailing spaces above.

強調、連結與圖片

星號或底線用來標記斜體和粗體文字，兩者結合則同時呈現斜體與粗體。連結使用方括號包住文字，圓括號包住網址；圖片使用相同語法，但前面加上 !。

*italic*  **bold**  ***bold italic***
[link text](https://example.com)
![alt text](/path/to/image.png)

清單與巢狀清單

無序清單使用 -、* 或 +。有序清單使用數字加上句點。縮排兩個或四個空格即可在清單中巢狀嵌入另一個清單。

- item one
- item two
  - nested item
1. first
2. second

表格

GitHub Flavored Markdown 新增了以直線符號分隔的表格。標題列下方以短橫線構成的一列會設定欄位結構，並可用於設定對齊方式。

| Name | Type |
| --- | --- |
| Alpha | text |
| Beta | number |

程式碼、引用區塊與水平分隔線

反引號標記行內程式碼，三個反引號則會開啟一個程式碼區塊，並可選擇加上語言標籤以啟用語法標示。行首的 > 標記引用區塊；堆疊多個 > 可形成巢狀引用。單獨一行的三個短橫線、星號或底線會畫出水平分隔線。

Use `git status` to check the working tree.

print("hello")

> A quoted sentence.
>> A nested quote.

---

任務清單與跳出特殊字元

GitHub Flavored Markdown 支援在清單項目中加入核取方塊。在特殊字元前加上反斜線，可讓該字元以原樣顯示，而不觸發格式化。大多數轉譜工具也允許在行內直接使用原始 HTML 標籤，不過本速查表僅專注於純 Markdown 語法。

- [x] done
- [ ] not done

Escaped: \* not italic \*

GitHub Flavored Markdown 與 CommonMark 的差異

CommonMark 定義了核心規則：標題、強調、清單、連結、程式碼區塊與引用區塊。GitHub Flavored Markdown 建立在 CommonMark 之上，並新增了表格、任務清單、刪除線，以及自動將裸網址轉為連結的功能。以其中一種格式撰寫的檔案通常都能在另一種格式中正常呈現，但表格和核取方塊需要具體支援 GitHub Flavored Markdown 才能運作。

進階語法：數學公式、註腳、前置資料與圖表

這些擴充功能的支援程度因轉譜工具而異，因此在依賴它們之前，請先確認目標工具是否支援。數學公式使用類似 LaTeX 的界定符，註腳使用插入符號和標籤，前置資料是檔案開頭的一段元資料區塊，圖表則使用帶標籤的程式碼區塊。

Inline math: $a^2 + b^2 = c^2$
Block math: $$E = mc^2$$

Text with a note.[^1]
[^1]: The note itself.

---
title: Example document
date: 2026-01-01
---

graph TD
  A --> B
  B --> C

整合運用

使用 Markdown Editor 撰寫並預覽文件，用 Markdown Lint 檢查語法問題，並用 Markdown TOC 產生目錄。需要可分享的檔案時，可用 Markdown to PDF 或 Markdown to Word 匯出。若想深入了解如何將 PDF 轉換回 Markdown，請參閱 PDF to Markdown guide。