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表格

  1. 貼上CSV資料 將CSV文字貼到輸入框中。如果是直接從試算表軟體複製的,請將分隔符改為定位字元(Tab)。
  2. 決定首行是否作為表頭 如果第一行是欄位名稱,請開啟「將首行作為表頭」,分隔行會自動插入到其下方。
  3. 選擇列的對齊方式 數值列右對齊通常更易讀。保持「不指定」則由Markdown渲染器採用其預設方式顯示。
  4. 複製結果並貼上 複製產生的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制定的擴充規範,已成為表格語法事實上的標準。
轉義
在儲存格內的豎線前加上反斜線,防止其被誤認為列分隔符的處理方式。

常見問題

這是一種用豎線(|)分隔單元格並排列在一行、且緊跟表頭行之後插入由 `---` 組成的分隔行、從而被識別為表格的記法。GitHub的README以及Qiita、Zenn等許多Markdown渲染器都支援這種語法。

通過在分隔行的連字元前後加上冒號(:)來指定。`:---` 表示左對齊,`:---:` 表示居中,`---:` 表示右對齊;本工具只需選擇對齊方式即可自動插入相應語法。

可以。用雙引號括起的單元格內的逗號不會被誤認為列分隔符,換行會被轉換為半形空格,因此從Excel等複製的複雜CSV也能在不破壞表格格式的情況下正確轉換。

不會。轉換處理全部在瀏覽器內的JavaScript中完成,輸入的CSV內容不會被發送到任何伺服器。
工具君

閒話 ― 為什麼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編寫文件的開發者的常見預處理步驟。