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 表格無法合併儲存格。替代做法:
- 重複填寫相同內容,讓表格保持規則。
- 把表格拆成兩個較小的表格。
- 內容複雜時,改用清單或小標題分段,通常更好讀。
從 Excel、Google 試算表轉成 Markdown 表格
試算表直接複製貼上會變成用 Tab 分隔的文字。轉換方式:
- 用文字編輯器把 Tab 取代成
|,並在每列頭尾補上|,再加上分隔線。 - 或使用網路上的「Excel to Markdown」轉換工具。
轉好之後貼到線上編輯器檢查欄位是否對齊。
寬表格的閱讀
欄位很多的表格在手機上會超出畫面。墨閱會讓表格可以左右捲動,不會擠壓整個版面。寫作時也可以:
- 把不重要的欄位拿掉。
- 把長文字欄位改成簡短關鍵字,細節寫在表格下方。
速查範本
| 項目 | 數量 | 金額 |
| :--- | ---: | ---: |
| 項目一 | 1 | 100 |
| 項目二 | 2 | 250 |
| **合計** | **3** | **350** |
更多語法請看 Markdown 語法教學;要把表格做成報告,可以參考 Markdown 轉 PDF。