如何將 CSV 轉換為 MD
- 貼上 CSV 文字或上傳支援的
.csv檔案。 - 確認分隔符號、引號字元、表頭列與字元編碼。
- 預覽解析後的列與產生的 Markdown 表格。
- 複製表格或下載
.md檔案。
轉換器會保留哪些內容？
| 來源內容 | 建議的輸出行為 | 轉換備註 |
|---|---|---|
| 表頭列 | 使用第一列或設定的列作為標題 | |
| 列與欄 | 保留解析後的矩形資料 | |
| 引號內的分隔符號 | 保留引號欄位內的逗號或分隔符號 | |
| 跳脫的引號 | 正確解碼雙引號字元 | |
| 空欄位 | 呈現空儲存格 | |
| 欄位中的換行 | 跳脫、取代或使用 HTML 換行 | |
| 垂直線字元 | 跳脫以確保 GFM 儲存格有效 | |
| 對齊 | 產生可選的欄位對齊 |
轉換期間可能發生哪些變化？
多行與豐富的儲存格內容
Markdown 表格儲存格對換行、清單與區塊內容的支援有限。
非常大的資料集
數千列可能產生技術上有效但難以閱讀的 Markdown 表格。發布前請檢視輸出。
字元編碼
以 Windows-1252、Shift_JIS 或其他字元集編碼的檔案，若以 UTF-8 解碼可能顯示錯誤。
不規則列
欄位數不同的列需要錯誤、修復規則或明確的填補策略。
資料型別
CSV 本身不保留數值、日期或布林型別；Markdown 呈現文字。
CSV 轉 Markdown 的常見用途
將資料加入 README
將精簡的相容性矩陣或功能清單轉換為版本控制的表格。
分享查詢結果
將小型匯出貼到 issue、pull request 或支援單中。
記錄 API 欄位
將儲存在 CSV 中的結構描述或欄位清單轉換為可讀的參考表格。
將表格筆記移至 Obsidian
建立可攜的文字表格，同時保留 CSV 以供進一步計算。
CSV 轉 Markdown 範例
Input
name,description,status
Alpha,"Fast, simple",active
Beta,"A | B",paused
Expected Markdown
| name | description | status |
|---|---|---|
| Alpha | Fast, simple | active |
| Beta | A \| B | paused |產生更乾淨 Markdown 輸出的提示
- 確認分隔符號 逗號、分號與 tab 分隔的檔案在純文字預覽中可能看起來相似。
- 使用真正的 CSV 解析器 簡單的字串分割會破壞引號內的逗號、跳脫引號與多行欄位。
- 限制文件中的列數 簡潔的表格比貼上整個資料集更有用。
- 轉換前檢查編碼 在解碼步驟修復亂碼字元，而不是在 Markdown 產生之後。
- 預覽垂直線與換行 這些字元若未一致地跳脫，可能破壞表格結構。
常見問題
CSV 的第一列會成為表格表頭嗎？
第一個有資料的列會成為 Markdown 表格的表頭。 若 CSV 直接以資料開始，請在轉換前準備表頭列。
垂直線字元會自動跳脫嗎？
會。 垂直線字元會被跳脫，以確保它們保留在正確的 GFM 表格儲存格內。
引號欄位內的逗號如何處理？
引號內的逗號會保留在同一儲存格內。 CSV 解析器也會處理跳脫的引號字元。
多行 CSV 儲存格會發生什麼事？
儲存格內的換行會變成 <br>。 這可讓列在 GitHub 風格的 Markdown 中保持矩形。
可以使用分號或 tab 作為分隔符號嗎？
可以。 分隔符號偵測支援逗號、分號、tab 與垂直線。
空儲存格會被保留嗎？
會。 空儲存格保持空白，不會移動後續欄位的值。
數值欄位可以靠右對齊嗎？
GFM 對齊標記可以表達左、中或右對齊。
CSV 檔案可以多大？
轉換器沒有固定的檔案大小限制。 非常大的 CSV 檔案可能需要較長的處理時間，且其 Markdown 表格可能難以閱讀，因此發布前請檢視大型輸出。
將 Markdown 轉回 PDF
已經有 Markdown 檔案？使用Markdown 轉 PDF 轉換器來建立可分享的 PDF。