Markdown 表格完整教學

表格是 Markdown 最實用、也最常寫錯的語法之一。這篇從基本格式開始,一路整理到對齊、換行、特殊符號與 Excel 轉換。邊看邊試的話,打開 Markdown 線上編輯器,貼上範例就能即時看到結果。

基本語法

表格由三部分組成:表頭、分隔線、資料列。欄位之間用 | 隔開。

| 姓名 | 部門 | 分機 |
| --- | --- | --- |
| 王小明 | 業務部 | 101 |
| 陳美玲 | 設計部 | 205 |

顯示效果:

姓名 部門 分機
王小明 業務部 101
陳美玲 設計部 205

重點:

  • 第二行的 --- 不能省略,每欄至少三個 -。
  • 頭尾的 | 可以省略,但保留比較好讀。
  • 各列的欄位數要和表頭一致。
  • 表格前後要空一行,否則可能被當成一般文字。

欄位對齊

在分隔線加上冒號 : 控制對齊:

| 靠左 | 置中 | 靠右 |
| :--- | :---: | ---: |
| 蘋果 | 10 | $30 |
| 香蕉 | 5 | $15 |
靠左 置中 靠右
蘋果 10 $30
香蕉 5 $15

數字、金額建議靠右,方便比較大小。

儲存格內放程式碼、連結與粗體

儲存格裡可以使用行內語法:

| 指令 | 說明 |
| --- | --- |
| `npm install` | 安裝套件,見[官方文件](https://docs.npmjs.com/) |
| **必填** | 這個欄位一定要填 |

儲存格裡要顯示「|」

直線符號會被當成欄位分隔,要在前面加反斜線:

| 運算子 | 意思 |
| --- | --- |
| `a \| b` | 位元 OR |

儲存格內換行

標準 Markdown 的表格不支援在儲存格內換行,每一列必須寫在同一行。常見做法:

  • GitHub:可以寫 <br> 換行,例如 第一行<br>第二行。
  • 墨閱:為了安全不執行 HTML 標籤,<br> 會原樣顯示。建議改成拆成多列,或改用清單呈現。

合併儲存格

標準 Markdown 表格無法合併儲存格。替代做法:

  1. 重複填寫相同內容,讓表格保持規則。
  2. 把表格拆成兩個較小的表格。
  3. 內容複雜時,改用清單或小標題分段,通常更好讀。

從 Excel、Google 試算表轉成 Markdown 表格

試算表直接複製貼上會變成用 Tab 分隔的文字。轉換方式:

  • 用文字編輯器把 Tab 取代成 |,並在每列頭尾補上 |,再加上分隔線。
  • 或使用網路上的「Excel to Markdown」轉換工具。

轉好之後貼到線上編輯器檢查欄位是否對齊。

寬表格的閱讀

欄位很多的表格在手機上會超出畫面。墨閱會讓表格可以左右捲動,不會擠壓整個版面。寫作時也可以:

  • 把不重要的欄位拿掉。
  • 把長文字欄位改成簡短關鍵字,細節寫在表格下方。

速查範本

| 項目 | 數量 | 金額 |
| :--- | ---: | ---: |
| 項目一 | 1 | 100 |
| 項目二 | 2 | 250 |
| **合計** | **3** | **350** |

更多語法請看 Markdown 語法教學;要把表格做成報告,可以參考 Markdown 轉 PDF。