Markdown 表格產生器

從格線到 Markdown：完整範例

假設你要做一張小型的方案價目表，四欄、四列資料。標題列依序是 Plan、Seats、Price、Support。放名稱的兩欄維持靠左，Seats 的數值很短所以置中，Price 設為靠右，讓價格的個位數對齊。

填完四列資料後，產生器會輸出這樣的內容：

| Plan       | Seats | Price | Support   |
| :--------- | :---: | ----: | :-------- |
| Starter    |   3   |    $0 | Community |
| Team       |  25   |   $49 | Email     |
| Business   |  100  |  $149 | Priority  |
| Enterprise | 500+  |  $299 | Dedicated |

這段輸出裡有三個細節值得看仔細一點。

輸出裡的三個細節

• 第二行是「分隔列」，它不是裝飾。少了它，這整塊根本不是表格，只是六行中間夾著管線符號的普通文字。
• 冒號才是決定對齊的關鍵。:--- 是靠左、:---: 是置中、---: 是靠右。
• 那些補齊欄寬的空白純粹是視覺效果。渲染時會被忽略，這也正是手動維護寬表格特別累人的原因。

同一張表，五個步驟

1. 把格線設成四欄、四列資料。
2. 在最上面那一列輸入四個標題。
3. 在 Seats 上方點置中，在 Price 上方點靠右。
4. 一列一個方案，把資料填完。
5. 複製 Markdown 區塊，貼到表格該去的地方。

把這段貼進編輯器，預覽窗格會立刻顯示排版後的表格，讓你在推進 README 之前先確認結果。如果有哪個語法看起來陌生，語法速查表把整個語言濃縮在一頁，而什麼是 Markdown 則說明為什麼加了標點的純文字會變成排版。

對齊：真正決定一切的那一列

對齊完全由分隔列決定，也就是每個 Markdown 表格的第二行。那一列的每個儲存格，描述的是它上下那一整欄。

所有分隔格寫法，合法與不合法

下面這張對照表涵蓋你會遇到的各種寫法，包括四種會讓表格直接失效的錯誤形式。

兩個讓對齊真正發揮作用的習慣

• 只要是數字就靠右。價格或數量欄位在個位數對齊時，比較起來輕鬆得多。
• 把對齊當成呈現層的事。有些靜態網站主題會用 CSS 覆寫它，純文字檢視器則完全忽略它。用它幫助閱讀就好，不要用它承載意義。

注意：分隔格寫錯不會得到一張歪掉的表格，而是完全沒有表格。整塊內容會退回成夾著管線符號的純文字。

為什麼表格是擴充語法，不是核心 Markdown

表格是 GitHub 帶進 Markdown 的，並不在 2004 年的原始規格裡，因此它屬於 GitHub 風格 Markdown 方言。現代工具幾乎都支援，但沒有啟用擴充的嚴格 CommonMark 解析器不會。想知道儲存格裡到底能放什麼，請看Markdown 表格指南；如何在 Markdown 中製作表格則提供最精簡的答案。

從 Excel、Google 試算表或 CSV 貼上

有些表格是一半自己想、一半從別處抄來的。版面在這裡設計，但數字早就躺在某張試算表裡。那些列可以直接貼進格線。

從試算表複製的 Tab 分隔資料

從 Excel、Numbers 或 Google 試算表複製一整塊儲存格時，剪貼簿帶的是以定位字元分隔的資料：一列一行，欄與欄之間夾一個 Tab。把它貼進格線，工具會自動拆回儲存格。四十列的表格只要按一次貼上，而不是老老實實打四十行。

逗號分隔的 CSV 文字

CSV 的行為完全一樣。以下是一份小型匯出檔的樣子：

Region,Q1,Q2
North,1420,1655
South,980,1130
East,2075,1980

貼進來之後，把兩個數字欄設成靠右，就會得到：

| Region |   Q1 |   Q2 |
| :----- | ---: | ---: |
| North  | 1420 | 1655 |
| South  |  980 | 1130 |
| East   | 2075 | 1980 |

貼上之前，有兩種儲存格需要先處理。

兩種要特別處理的儲存格

• 含有管線符號的儲存格。| 正是欄位分隔符號，所以那一列會被切成兩半。把它跳脫成 \| 就能保持完整。寫鍵盤快速鍵、正規表示式或命令列語法的人最常踩到這個坑。
• 含有換行的儲存格。表格列必須待在同一行，請把換行改成 <br>。

整張表都有了？那就用轉換器

這裡值得畫一條線。如果表格已經做完，你只是想要它的 Markdown 版本，用這張格線就是繞遠路。請改用表格轉 Markdown 工具：它讀得懂試算表儲存格、CSV 文字，甚至一段原始 HTML <table>，貼一次就把語法交給你。

小提醒：一格一格新做出來的，留在這一頁；已經存在、只是要翻譯的，交給轉換器。這一個問題就決定了哪一頁比較省時間。

如果要處理的是整份文件而不是單一表格，貼上的網頁交給 HTML 轉 Markdown 工具，反方向則由 Markdown 轉 HTML 負責。

常見問題與修法

壞掉的 Markdown 表格幾乎逃不出四種情況，而且每一種都有看得見的症狀。

表格變成一整片夾著管線符號的文字

十次有九次是分隔列不見了、格式寫錯，或者表格上方沒有空白行。表格與前一段之間必須隔一個空行，而且第二行一定要是那列連字號與冒號。

欄數對不上

標題列有四格、分隔列只有三格時，多數解析器會乾脆放棄整個表格。資料裡混進管線符號則是同一個問題的另一種方向，因為它會多生出一格。請跳脫成 \|。用反引號包成行內程式碼也沒用，行內程式碼並不能保護表格儲存格裡的管線符號。

用格線產生就完全不會發生這種事，這也是三欄以上就該用產生器的主要理由。

對齊看起來沒有生效

先檢查目的地而不是語法。有些文件主題與電子郵件用戶端會移除表格的 CSS，少數舊解析器支援表格卻不支援對齊。先在 Markdown 檢視器或編輯器裡確認語法本身正確，再去怪罪它。

表格太寬，或某一格塞太多東西

• 九欄的表格。在手機上根本沒辦法讀，存成 PDF 時右側也會被裁掉。刪掉可有可無的欄位、縮短標題文字，或把表格轉九十度，讓長的那一軸沿著頁面往下走。
• 儲存格裡的換行消失了。這是正常行為，單純斷行請改用 <br>。
• 儲存格需要好幾段文字、清單或程式碼區塊。那份內容已經不適合放在表格裡，改用有小標題的段落，或直接寫原生標籤，這個取捨在 Markdown 與 HTML 的比較裡有完整討論。