這是什麼
手寫 Markdown 表格很麻煩:每一列都要直線,第二列要寫橫線,手動對齊欄位更是耗時。這個工具把 CSV 或 TSV 資料轉換成 GitHub Flavored Markdown 表格,可以直接貼到 README、Pull Request、Issue、Wiki 頁面或任何使用 Markdown 的文件中。
CSV 會被正確解析,含逗號的引號欄位、重複的引號和多行儲存格都能處理。輸出會補齊空白,讓各欄在純文字中也對得整齊,日後閱讀和修改都方便。
怎麼用
- 貼上 CSV 或 TSV,上傳
.csv或.tsv檔案,或按 範例。 - 選擇 對齊方式:預設、靠左、置中、靠右,或 數字靠右(只含數字的欄靠右)。
- 如果第一列是欄位名稱,保持 第一列是標題列 開啟;否則標題會是 Column 1、Column 2 等。
- 如果想要不補空白的精簡列,關閉 欄寬對齊。
- 複製表格或下載成
.md檔。
儲存格比標題少的列會用空白儲存格補齊,所以產生的表格一定有效。
範例
下面這段 CSV:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier
選擇 數字靠右 後會變成這個 Markdown 表格:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |
引號欄位中的逗號留在儲存格裡,直線被跳脫,數字欄標記為 --:,算繪時靠右對齊。
小提示
- 第二列的對齊標記(
:--、:-:、--:)決定算繪後每一欄的對齊方式。 - 儲存格中的行內 Markdown,例如
**粗體**、行內程式碼或連結,會原樣保留,多數檢視器都會算繪。 - 很寬的表格在小螢幕上不易閱讀,可以考慮把欄位拆成幾個表格。
- 想產生 HTML 表格,或把 JSON 陣列轉成 Markdown 表格,可以使用下方的相關工具。
常見問題
› 產生的是哪一種 Markdown 表格?
GitHub Flavored Markdown(GFM)的直線表格,GitLab、Bitbucket、Notion、Obsidian、Docusaurus、MkDocs 和多數靜態網站產生器也都支援。純 CommonMark 沒有表格語法。
› 儲存格裡的直線和換行怎麼處理?
直線會結束儲存格,所以寫成 \|。表格的一列中不能換行,所以換行會變成 <br> 標籤,GitHub 和多數算繪器會把它顯示成換行。
› 為什麼中文、日文、韓文的欄也能對齊?
開啟「欄寬對齊」時,會依顯示寬度補空白:東亞全形字元算兩欄,所以在等寬字型的編輯器中原始 Markdown 也是對齊的。算繪後的表格不論是否對齊都一樣。
› 可以轉換從 Excel 或 Google 試算表複製的內容嗎?
可以。從試算表複製的儲存格以 Tab 分隔,分隔符號會自動偵測,也可以手動選擇 Tab。