CSV轉Markdown表格轉換器
將CSV檔案轉換為Markdown表格語法(`| col1 | col2 |`)。可指定分隔符、是否將首行作為表頭,以及列對齊方式(左對齊、居中、右對齊)。轉換結果可複製或下載。轉換完全在瀏覽器中進行,不會將資料傳送到伺服器。
| 分隔符 |
|
|---|---|
| 將首行作為表頭 | |
| 列對齊方式 |
|
輸入CSV資料後,這裡會顯示生成的Markdown表格。
CSV行與Markdown表格的對應關係
| CSV的一行 | name,age,city |
|---|---|
| 轉換後的Markdown語法 | | name | age | city | |
當首行作為表頭使用時,第1行為表頭行,第2行為表示對齊方式的分隔行(---),從第3行開始為各資料行。
CSV轉Markdown表格轉換器是什麼
Markdown表格完全由豎線和連字元組成,列數一多,手動敲出來就很麻煩。如果原始資料本來就是CSV——例如從試算表匯出、資料庫查詢結果或記錄檔——就沒必要逐格重新輸入。本工具會讀取CSV內容,自動產生表頭行、表示對齊方式的分隔行,以及對應每一行資料的資料行。
由於Markdown表格的每一行都必須寫在同一實體行內,轉換過程中會自動處理一些細節:儲存格內的豎線會被轉義,避免被誤認為列分隔符;用引號括起的多行儲存格中的換行會被替換為半形空格。你還可以為列選擇左對齊、居中或右對齊,系統會在分隔行中插入對應的冒號與連字元組合。整個轉換過程都在瀏覽器本機完成,貼上的CSV內容不會離開你的電腦。
如何用CSV產生Markdown表格
- 貼上CSV資料 將CSV文字貼到輸入框中。如果是直接從試算表軟體複製的,請將分隔符改為定位字元(Tab)。
- 決定首行是否作為表頭 如果第一行是欄位名稱,請開啟「將首行作為表頭」,分隔行會自動插入到其下方。
- 選擇列的對齊方式 數值列右對齊通常更易讀。保持「不指定」則由Markdown渲染器採用其預設方式顯示。
- 複製結果並貼上 複製產生的Markdown,貼到README、Issue、PR說明或技術文章中。
用好本工具的小技巧
- 單元格中包含豎線(|)時會自動轉義為 \| ,以防止被誤認為是列分隔符。
- 用引號括起的多行單元格中的換行會被替換為一個半形空格,因為Markdown表格的每一行必須在物理上佔一行。
- 選擇"左對齊"、"居中"或"右對齊"後,分隔行中會插入 `:---`、`:---:` 或 `---:`,使GitHub等渲染器按預期的對齊方式顯示。
- 搭配姊妹工具"CSV轉JSON"和"CSV轉SQL"使用,可以將同一份CSV轉換為按需選擇的三種輸出格式。
CSV轉Markdown的應用場景
在README中展示表格
先在試算表中整理好對照表或設定項目清單,再轉換,就能得到排版整齊的Markdown表格,不需手動調整欄寬。
在Issue或PR中展示比較
可以當場把測試結果或候選方案整理成表格。由於仍是純文字,在diff中也能正常閱讀。
為技術文章做資料準備
量測到的資料可以直接變成文章中的表格。數值列右對齊能讓位數對齊,便於瀏覽。
整理會議記錄與文件
把原本用試算表管理的清單遷移到用Markdown維護的文件時非常好用。
Markdown表格相關術語
- 表格語法
- 用豎線分隔儲存格來表示表格的Markdown寫法。不屬於最初的規範,是後來作為擴充功能加入的。
- 分隔行
- 緊跟在表頭行之後的連字元行,用來告訴解析器表頭到此結束、資料從下一行開始。
- 對齊標記
- 在分隔行的連字元旁加上冒號,用來指定該列是左對齊、居中還是右對齊。
- GFM
- GitHub Flavored Markdown的縮寫,是GitHub制定的擴充規範,已成為表格語法事實上的標準。
- 轉義
- 在儲存格內的豎線前加上反斜線,防止其被誤認為列分隔符的處理方式。
常見問題
閒話 ― 為什麼Markdown表格僅靠豎線和連字元就能表達
Markdown由John Gruber和Aaron Swartz於2004年提出,是一種輕量級標記語言,其設計理念的核心是"即使以純文本形式閱讀也能理解含義"。表格語法也不例外:由於僅用豎線和連字元來表現表格線,因此不像HTML的<table>標籤那樣需要用開始和結束標籤包裹,僅憑轉換前的原始碼就能大致想像出表格的形狀。
Markdown的表格語法最初並不包含在John Gruber本人制定的原始規範中,而是後來由PHP Markdown Extra以及更具影響力的GitHub Flavored Markdown(GFM)作為擴充套件功能加入的。因此不同實現之間在細節行為(例如列數不一致時的處理方式)上會存在細微差異,GitHub、GitLab等主流平臺大體上都遵循GFM規範。
希望將電子表格或資料庫查詢結果直接貼上到文件中的需求,在撰寫README、Issue以及技術部落格時經常出現。手動敲出豎線和分隔行相當繁瑣,因此能夠一鍵從CSV轉換的工具,已成為使用Markdown編寫文件的開發者的常見預處理步驟。