CSV轉Markdown表格轉換器
將CSV檔案轉換為Markdown表格語法(`| col1 | col2 |`)。可指定分隔符、是否將首行作為表頭,以及列對齊方式(左對齊、居中、右對齊)。轉換結果可複製或下載。轉換完全在瀏覽器中進行,不會將資料傳送到伺服器。
| 分隔符 |
|
|---|---|
| 將首行作為表頭 | |
| 列對齊方式 |
|
已複製!
輸入CSV資料後,這裡會顯示生成的Markdown表格。
CSV行與Markdown表格的對應關係
| CSV的一行 | name,age,city |
|---|---|
| 轉換後的Markdown語法 | | name | age | city | |
當首行作為表頭使用時,第1行為表頭行,第2行為表示對齊方式的分隔行(---),從第3行開始為各資料行。
Tips
- 單元格中包含豎線(|)時會自動轉義為 \| ,以防止被誤認為是列分隔符。
- 用引號括起的多行單元格中的換行會被替換為一個半形空格,因為Markdown表格的每一行必須在物理上佔一行。
- 選擇"左對齊"、"居中"或"右對齊"後,分隔行中會插入 `:---`、`:---:` 或 `---:`,使GitHub等渲染器按預期的對齊方式顯示。
- 搭配姊妹工具"CSV轉JSON"和"CSV轉SQL"使用,可以將同一份CSV轉換為按需選擇的三種輸出格式。
常見問題
這是一種用豎線(|)分隔單元格並排列在一行、且緊跟表頭行之後插入由 `---` 組成的分隔行、從而被識別為表格的記法。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編寫文件的開發者的常見預處理步驟。