表格轉 Markdown 轉換器

從 HTML 表格到 Markdown：完整範例

假設你正要把一個頁面從舊的 CMS 搬進程式碼倉庫。你打開原始碼、把表格那一段複製下來，剪貼簿裡的內容長這樣：

<table>
  <thead>
    <tr><th>Team</th><th>Lead</th><th>Headcount</th></tr>
  </thead>
  <tbody>
    <tr><td>R&amp;D</td><td>Mei Lin</td><td>42</td></tr>
    <tr><td>Support</td><td>Dave Okoro</td><td>18</td></tr>
    <tr><td>Sales &amp; Marketing</td><td>Ana Ruiz</td><td>7</td></tr>
  </tbody>
</table>

貼進轉換器之後，拿到的 Markdown 完全是這樣：

| Team              | Lead       | Headcount |
| :---------------- | :--------- | :-------- |
| R&D               | Mei Lin    | 42        |
| Support           | Dave Okoro | 18        |
| Sales & Marketing | Ana Ruiz   | 7         |

從輸入跳到這個結果的過程中，工具替你做了三個決定，每一個都值得說清楚。

轉換器默默做掉的三件事

• <thead> 那一列成了 Markdown 的標題列，下面自動補上分隔列，正是手寫時最惱人的部分。
• HTML 實體 & 被還原成單純的 &，因為 Markdown 是純文字，用不到實體編碼。
• 每一欄都補空白到相同寬度。渲染時會忽略這些空白，但看 diff 的同事會很感謝你。

整趟流程只有四步

1. 從開始標籤到結束標籤，複製完整的 <table> 元素。
2. 貼進本頁最上方的輸入框。
3. 把 Headcount 的分隔格從 :-------- 改成 --------:，因為那一欄放的是數字。
4. 複製產生的 Markdown，貼進你的檔案。

第三步是整趟流程唯一需要動手的地方。想先確認結果，就把整段貼進編輯器：即時預覽會在它進入倉庫之前，先證明表格渲染得出來。

各種來源實際上貼出什麼

「複製表格」這句話，從不同地方複製的意思其實差很多，而這個差異決定了轉換是乾淨俐落還是要收拾殘局。

逐一來源：剪貼簿裡到底是什麼

以下是大家最常複製的來源、每一種實際交出的內容，以及各自最容易讓人踩雷的細節。

為什麼試算表是最好的中繼站

最後一欄其實藏著一個規律：貼得乾淨的來源都是試算表，會出狀況的則都是「看起來像格線、其實不是」的東西。所以某個來源怎麼貼都不對時，先丟進 Excel 或 Google 試算表把欄位整理好，再從那裡複製到本轉換器。多按一次貼上，還是遠比重打三十列快。

注意：PDF 是唯一一種結構已經救不回來的來源。它的文字是逐行送出、完全沒有分隔符號，任何轉換器都猜不出原本的欄位在哪裡。

轉換器還是產生器：你要的是哪一個？

這一頁與 Markdown 表格產生器是完全相反的兩件事，選錯會白白多花幾分鐘。只要問一個問題就能分辨：資料已經存在了嗎？

資料在別的地方，就用轉換

手上已經有試算表、匯出檔、CSV 或一段 HTML 時，用這一頁。這是翻譯工作而不是創作，你不該重打任何一格。格式判斷、標題列與分隔列都由工具處理掉。

表格還不存在，就用產生

內容要邊想邊填時，用表格產生器：小型比較表、價目表、參數對照表都屬於這一類。它給你一張空格線，每一欄還有自己的對齊按鈕，比在純文字框裡跟管線符號搏鬥輕鬆得多。

小提醒：選得起來、複製得下來的，就用轉換；要自己想出來的，就用產生。這條規則每次都能決定答案。

三行 CSV 的實際結果

一個小例子就看得出這個方向有多省事。輸入這樣的內容：

Region,Q1,Q2
North,1420,1655
South,980,1130

立刻就會拿到這樣的結果：

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

如果你想真正弄懂語法而不只是產生它，Markdown 表格指南完整說明對齊、跳脫與儲存格內容，如何在 Markdown 中製作表格則給你最精簡的答案。表格從來不屬於原始的 Markdown，而是隨 GitHub 風格 Markdown 一起出現的，這也是為什麼沒有啟用擴充的嚴格 CommonMark 解析器，會把你的表格當成純文字原樣顯示。

常見問題與修法

幾乎所有失敗的轉換都逃不出四種情況，而且每一種都有看得見的症狀。從畫面上看到的現象往回推最快。

某一列被切成太多欄

幾乎都是資料裡混進了管線符號。| 正是欄位分隔符號，所以內容為 a | b 的儲存格會變成兩格。把它跳脫成 \| 就好：

| Pattern  | Meaning        |
| :------- | :------------- |
| cat|dog  | 這一列會壞掉    |
| cat\|dog | 正確的跳脫寫法  |

逗號在 CSV 裡會造成一樣的麻煩。台北, 台灣,2.6M 是三個欄位，"台北, 台灣",2.6M 才是兩個。請重新匯出並啟用引號，或改從試算表以 Tab 分隔的方式貼上，那樣根本不會發生這件事。

貼上 HTML 卻沒有任何輸出

先確認你複製的是含結束標籤的完整 <table> 元素。只從 <tr> 開始的片段，解析器根本找不到表格。從渲染後的網頁而不是原始碼複製也可以，只是那段文字已經被攤平，會被判定成 TSV。

列的形狀不對

• 各列長度不一。合併儲存格與長短不齊的匯出檔，會產生比標題列少幾格的資料列。多數解析器不會替你猜，而是乾脆拒絕渲染，請用空儲存格補齊，讓每一列的管線符號數量一致。
• 儲存格裡有換行。Markdown 的表格列必須待在同一行，請把換行改成 <br>。
• 儲存格需要好幾段文字、清單或程式碼區塊。那份內容已經不適合放進表格，改用有小標題的段落比較好，這個取捨在 Markdown 與 HTML 比較裡有完整討論。

輸出變成一整片夾著管線符號的文字

不是分隔列不見了，就是表格與上一段之間少了空白行。把整塊丟進 Markdown 檢視器確認語法無誤，再去懷疑目的地平台。也要記得太寬的表格在存成 PDF 時右側會被裁掉。整份文件的雙向轉換，則交給 HTML 轉 Markdown 與 Markdown 轉 HTML。