CSV 轉 Markdown 表格轉換器
手打 Markdown 表格,每一行都得數直線符號和破折號。改成上傳 CSV,就能得到含標題列與分隔列的表格,直接貼進 README、Wiki 頁面或筆記本。
資料轉換器
或將CSV, TSV, TXT … 檔案拖曳到這裡 ·
每個檔案最大 95 MB· 最多 20 個檔案· 30 分鐘後刪除
檔案會在我們的伺服器上處理,並於 30 分鐘後刪除。
CSV 與文字檔中分隔欄位的字元,讀取與寫入都會使用。自動會從輸入偵測,並以逗號寫出。
UTF-8 適用於所有語言。若 Windows 上的 Excel 開啟 CSV 時重音字元或亞洲文字出現亂碼,請選擇含 BOM 的 UTF-8。
適用於 Excel、ODS 與 Numbers 輸入:只轉換第一個工作表,或轉換所有工作表(每個工作表輸出一個 CSV 並打包成 ZIP,或每個工作表對應一個 JSON 鍵)。
新試算表中工作表索引標籤的名稱,最多 31 個字元。
物件陣列會以欄位名稱作為每列的鍵;陣列的陣列較精簡,並將標題保留為第一個陣列。
包住所有列的外層元素名稱;每一列會成為其中的 <row>。
用於 CREATE TABLE 與 INSERT 陳述式。僅限字母、數字與底線。
不同資料庫的引號與欄位類型略有差異;請選擇您要匯入的資料庫。
將日期儲存格統一改寫成一種格式。ISO (2026-10-18) 對資料庫與程式碼最保險;保持原樣則維持來源中的顯示方式。
使用方式
- 1
上傳 CSV
加入 .csv、.tsv 或以分隔符號區隔的 .txt 檔案,一次最多 20 個,每個最大 95 MB。自動偵測可辨識逗號、分號、Tab 和直線符號。
- 2
確認標題列
第一列為標題列預設為開啟,因此第 1 列會成為表格標題。如果檔案一開始就是資料,請在進階設定中關閉。
- 3
轉換並貼上
按下轉換為 Markdown table,開啟 .md 檔案,再把表格貼到 README、pull request、issue 或筆記中。
如何將 CSV 檔案轉成 Markdown 表格?
上傳 CSV 後按下轉換為 Markdown table。第一列會成為表格標題,下方會加入一列虛線,其他每一行則成為以直線符號分隔儲存格的資料列。
開發者為什麼要把 CSV 轉成 Markdown
文件最後往往都寫在 Markdown 檔案裡。維護者想在 README 放一張支援版本表,工程師把效能測試數字貼進 pull request,研究人員在 Obsidian 裡維護閱讀清單。這些數字通常一開始在試算表或程式輸出的 CSV 中,要手動重建、在每個儲存格之間加上直線符號,既慢又容易出錯。
John Gruber 在 2004 年發表的原始 Markdown 完全沒有表格。直線符號語法透過 PHP Markdown Extra 流傳開來,並在 2017 年被寫入 GitHub Flavored Markdown 規格,因此能在 GitHub 和大多數遵循它的工具上使用。如果資料來自 Excel,請先用 Excel 轉 CSV 儲存,再到這裡轉換。
CSV 轉 Markdown 表格範例
執行環境,版本,狀態 Python,3.13,支援中 Python,3.9,已停止支援 | 2025 年 10 月 Node.js,22,支援中
| 執行環境 | 版本 | 狀態 | | --- | --- | --- | | Python | 3.13 | 支援中 | | Python | 3.9 | 已停止支援 \| 2025 年 10 月 | | Node.js | 22 | 支援中 |
轉換後的 Markdown 表格會在哪裡顯示
| 機構 | 規定 | 來源 |
|---|---|---|
| GitHub | 依照 GFM 規格,在 README、issue、pull request 和 wiki 中轉譯直線符號表格。 | GFM 規格 |
| GitLab | GitLab Flavored Markdown 會在儲存庫、issue 和 merge request 中轉譯相同的直線符號表格。 | — |
| Obsidian | 在閱讀檢視中顯示直線符號表格,並在即時預覽中提供表格編輯功能。 | — |
| Jupyter | notebook 中的 Markdown 儲存格會在程式碼旁轉譯直線符號表格。 | — |
| CommonMark | 核心規格沒有表格語法;轉譯器需要表格擴充功能。 | commonmark.org |
CSV 與 Markdown 格式小知識
CSV
逗號分隔值
CSV 是一種純文字的表格格式,每一行是一列資料,欄位之間以逗號分隔。它從電腦發展初期沿用至今,並記載於 RFC 4180,不過許多變體會改用分號或定位字元,文字編碼也各不相同。幾乎所有試算表、資料庫和分析工具都能匯入與匯出,因此成為系統之間傳輸資料的預設格式。CSV 只儲存數值,不包含公式、格式、多個工作表或資料類型。
- 壓縮方式
- –
- 透明度
- –
- 動畫
- –
- 推出年份
- –
MD
Markdown
Markdown 是 John Gruber 於 2004 年建立的輕量標記語法。它使用純文字符號,例如以 # 表示標題、* 表示強調、- 表示清單,以原始文字顯示時仍易於閱讀,也能乾淨地轉換為 HTML。它是 README 檔、技術文件、Wiki、筆記 App 和許多靜態網站產生器的標準。它有多種方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等細節上略有差異。任何文字編輯器都能開啟 .md 檔。
- 壓縮方式
- –
- 透明度
- –
- 動畫
- –
- 推出年份
- 2004 · John Gruber
當小型資料集需要放進文件時,就會把 CSV 轉成 Markdown:例如 README 中的相容性表格、變更記錄中的版本清單、比較效能測試結果的 pull request,或個人知識庫中的一則筆記。
就數值而言,轉換幾乎不會有損失,但原本的用途並非如此。CSV 保留每一列供軟體讀取;Markdown 表格則是給人看的資料樣貌,沒有資料型別、公式,也無法合併儲存格。請將 CSV 留在儲存庫中作為來源,數字變動時再重新產生表格。
CSV 轉 Markdown 常見問題
Markdown 表格可以在哪裡顯示?
只要轉譯器支援直線符號表格擴充語法就可以:GitHub、GitLab、Obsidian、Jupyter notebook,以及 MkDocs、Hugo 等靜態網站產生器。嚴格遵循 CommonMark 的轉譯器則會把同樣的內容顯示為帶有直線符號的純文字。
CSV 的值裡有直線符號「|」怎麼辦?
未跳脫的 | 會開啟新的儲存格,使後面的每一欄都往右移。轉換器會將它寫成 \|,這是 GitHub Flavored Markdown 定義的跳脫寫法,因此直線符號會以文字形式顯示在儲存格內。
可以讓數字靠右對齊嗎?
可以,編輯分隔列即可:---: 為靠右對齊,:---: 為置中,:--- 為靠左對齊。請在轉換後再加上冒號;它只會影響表格的顯示方式,不會改變資料。
多大的 CSV 適合轉成 Markdown 表格?
Markdown 表格是給人閱讀的,因此幾十列、少數幾欄最合適。數千列的表格雖然可以轉換,但會讓 README 很難捲動;建議改為連結到儲存庫中的 CSV 檔案,並只顯示一份範例。
CSV 欄位裡的換行會怎麼處理?
Markdown 表格的每一列必須在同一行內,所以跨越多行的帶引號 CSV 值無法原樣保留。請在轉換前先取代這些換行;在 GitHub 上,可以在儲存格內使用 <br> 強制換行。
可以改把表格轉成 HTML 嗎?
如果目標是網頁、CMS 或電子郵件,而不是 Markdown 檔案,請將轉換為設為 HTML table。如果資料原本是 JSON,JSON 轉 HTML 頁面已預先選好該輸出。