Excel 轉 Markdown 表格

試算表比 CSV 多帶了三樣東西

• 合併儲存格。Markdown 沒有跨欄或跨列。合併範圍的值留在左上角那一格,其餘是空的 —— 檔案本來就是這樣存的。 如果那個合併是標題,通常該在方框裡把那一列刪掉再轉。
• 公式。拿到的是 Excel 最後一次計算的結果,不是公式本身。給人讀的表格本來就該這樣; 但從沒被計算過的活頁簿(某些程式產生的檔案)會是空白,在 Excel 裡打開存一次就好。
• 數字格式。顯示成 NT$8,600 的儲存格,裡面存的是 8600。Markdown 沒有格式, 把單位寫進標題(營收(元))會比每一格都加符號乾淨。

中文表格的對齊:一個字算兩格

Markdown 表格的原始碼要對齊,靠的是在每一格後面補空格。問題是,等寬字型裡一個中文字大約佔兩個英文字母寬, 如果照「字數」補空格,中文表格在編輯器裡永遠是歪的。這裡依顯示寬度計算:中文、日文假名、韓文、全形符號算兩格, 英數算一格。

要說清楚的是:對齊只影響原始碼好不好讀。GitHub、HackMD 渲染出來的表格長得一模一樣,不管補了多少空格。 取消勾選「補空格讓原始碼對齊」會得到精簡版,放進 diff 比較短。

讓手寫 Markdown 表格壞掉的三件事

• 儲存格裡有「|」。像 A|B 這樣的值會提早結束那一格,後面每一欄都往右錯位。這裡會跳脫成 \|。
• 儲存格裡有換行。Markdown 表格一列就是一行,儲存格裡的換行(Excel 裡的 Alt+Enter)會把那一列拆斷。 這裡換成 <br>,在 GitHub 和大多數 wiki 上會顯示成格內換行。
• 列不齊。比標題列少格的列會讓表格壞掉,這裡會補齊空格。

讀的是哪一個工作表

轉換的是活頁簿裡第一個沒有隱藏的工作表,載入方框時已經變成 CSV。要轉別的工作表,先用 XLSX 線上檢視 選那個工作表匯出成 .csv,再拖進來。

這個工具不做的事

• 不自動靠右對齊數字欄。分隔列一律寫成靠左;要靠右,貼上之後自己在分隔列加冒號(|---:|)。
• 不保留顏色、粗體與連結。Markdown 表格只有文字。
• 不支援舊的 .xls。請先在 Excel 另存成 .xlsx。

每次發版都要從同一份來源檔重產的表格,應該放進發版腳本。如果那份表本身是每個月交出去的報表, TableDI 2 是一套桌面軟體，專做每期都要重來一遍的表格工作：來源、規則和交付方式存成一個作業，下個月把新檔案放進去再跑一次。全部在你自己的電腦上執行。