單元 5 · 表格與進階區塊 · Markdown 繁中教學站

表格 · Tables

表格是 GitHub Flavored Markdown 的擴充語法（標準 Markdown 沒有）。用 | 分隔欄位，第二行放「表頭分隔線」。

原始碼 · SOURCE

| 水果 | 價格 | 產地 |
|------|------|------|
| 蘋果 | 30   | 日本 |
| 香蕉 | 25   | 台灣 |

渲染結果 · RENDERED

水果	價格	產地
蘋果	30	日本
香蕉	25	台灣

在表頭分隔線的冒號位置控制對齊：:--- 靠左、---: 靠右、:---: 置中。

原始碼 · SOURCE

| 靠左 | 置中 | 靠右 |
|:-----|:----:|-----:|
| 1    | 2    | 3    |

渲染結果 · RENDERED

靠左	置中	靠右
1	2	3

提醒：表格分隔線的 - 至少要一個；表格內若要顯示 |，用 \| 跳脫。每列欄位數最好一致，否則渲染會怪怪的。

用 > 開頭。常用來放引言、重點、或「引用他人意見」。

原始碼 · SOURCE

> 這是引用。
>
> > 巢狀引用也可以。

一般段落。

渲染結果 · RENDERED

這是引用。

巢狀引用也可以。

一般段落。

三個以上的 -、*、_ 都能畫出水平線。注意：上面要有空行，否則 - 會被當成二級標題或清單。

原始碼 · SOURCE

第一章

---

第二章

渲染結果 · RENDERED

第一章

第二章

常見陷阱：在標題下面緊接著寫 --- 會被當成「二級標題」。段落後面連續 --- 則可能被當成清單。保險起見，分隔線前後都留空行。

Markdown 遇到不認識的語法就直接放行——你可以嵌入 HTML 做到「更精細的排版」。例如 <details> 摺疊區塊、<div> 分欄。

原始碼 · SOURCE

<details>
<summary>點開看更多</summary>

摺疊的內容，**還可以用 Markdown**。

</details>

渲染結果 · RENDERED

點開看更多

摺疊的內容，還可以用 Markdown。

原則：先想清楚 Markdown 能不能達成，不能再用 HTML。保持原始檔可讀性，是 Markdown 的初衷。

想在原始檔留話給自己、但不要顯示給讀者看，用 HTML 註解。

原始碼 · SOURCE

<!-- TODO: 補上參考來源 -->

這段會顯示。

渲染結果 · RENDERED

這段會顯示。（第一行註解不會出現）

看完這頁你應該能說出：