CSV转Markdown表格

将CSV转换为Markdown表格

加载示例

CSV输入

Markdown输出

本地运行 · 粘贴密钥安全无忧

Markdown表格将在此处显示…

本地运行 · 粘贴密钥安全无忧

Markdown表格将在此处显示…

也可以试试：CSV转JSON CSV转HTML表格 CSV 格式化工具 CSV 转 SQL

什么是CSV转Markdown转换？

将CSV转换为Markdown表格是开发者的常见任务。CSV（逗号分隔值）以纯文本形式存储表格数据，每行为一条记录，字段之间用逗号或制表符等分隔符隔开。它是电子表格、SQL客户端和数据分析工具的默认导出格式。CSV文件紧凑、易于生成，但本身没有控制数据显示样式的机制。在文本编辑器中打开CSV文件，呈现的是一堆逗号分隔的字符串，机器可读，但人工浏览时十分费力。

Markdown表格解决了可读性问题。它们由GitHub风格Markdown（GFM）规范定义，并受到GitHub、GitLab、Bitbucket、Notion、Obsidian以及Hugo、Jekyll等静态网站生成器的支持——凡是处理Markdown的地方，均可渲染为整洁的HTML表格。语法使用竖线字符分隔列，并在表头行与正文行之间加入一行必填的分隔符（由短划线组成）。

将CSV转换为Markdown表格，就是将每一行包装成竖线分隔的语法，并在表头后插入分隔符行。CSV的第一行成为表头，后续每行成为正文行。每当需要将结构化数据粘贴到README、拉取请求描述、Wiki页面或任何Markdown文档系统时，都需要进行此操作。

为什么使用此工具？

此转换器在浏览器中解析CSV，即时生成Markdown表格输出，数据不会发送至任何服务器。

⚡

即时生成表格

粘贴CSV即可立即获得格式正确的Markdown表格，无需等待上传或服务器处理，输入时实时更新。

🔒

隐私优先处理

数据保留在浏览器标签页中，不会通过网络传输。适合处理不应离开本机的内部数据集、凭证或专有信息。

📋

一键复制输出

一键将Markdown表格复制到剪贴板，可直接粘贴到GitHub README、Issue、PR描述、Confluence页面或任何Markdown编辑器。

🔀

分隔符自动检测

工具自动识别逗号、制表符、分号和竖线分隔符，无需将CSV统一为单一格式即可生成有效输出。

CSV转Markdown使用场景

README文档

将配置选项、API端点或环境变量的CSV文件转换为Markdown表格，放入项目README，使文档与数据导出保持同步。

拉取请求描述

在GitHub或GitLab的PR描述中以Markdown表格形式粘贴测试结果、基准对比或迁移摘要，方便审阅者直接扫描数据，无需打开单独文件。

DevOps运维手册

将服务器、端口或服务端点的CSV清单转换为Markdown表格，用于存储在Git中的团队Wiki和事故响应运维手册。

QA测试报告

将CI流水线导出的CSV测试结果转换为Markdown表格，可在Jira、Confluence或Notion工单中直接渲染，供相关方审阅。

数据工程文档

将从数据目录以CSV格式导出的数据模式定义或列元数据转换为Markdown表格，纳入数据流水线文档。

学术与学生作业

将来自Kaggle或政府开放数据平台的数据集转换为Markdown表格，用于研究笔记、实验报告或Jupyter Notebook文档。

Markdown表格语法参考

Markdown表格遵循GitHub风格Markdown（GFM）规范。每张表格都需要表头行、分隔符行以及一行或多行正文行，分隔符行控制列的对齐方式。

元素	语法	说明
Column separator	\|	Separates each cell within a row
Header row	\| Name \| Age \|	First row of the table, defines column names
Separator row	\| --- \| --- \|	Required second row; separates header from body
Left align	\| :--- \|	Default alignment — colon on the left side
Center align	\| :---: \|	Colons on both sides of the dashes
Right align	\| ---: \|	Colon on the right side only
Escaped pipe	\\|	Use backslash to include a literal pipe in cell text

CSV与Markdown表格对比

两种格式均以纯文本表示表格数据。CSV面向机器和数据流水线；Markdown表格面向阅读文档的人。

CSV

面向机器。字段由分隔符（逗号、制表符、分号）分隔。无对齐控制，无渲染——在文本编辑器中看到的就是原始值。所有电子表格、数据库导出工具和编程语言均支持CSV。适合数据交换和存储。

Markdown Table

面向人类。列由竖线字符分隔，并需要一行短划线分隔行。支持按列设置左对齐、居中和右对齐。在GitHub、GitLab、Notion和静态网站生成器上渲染为HTML表格。适合文档、README及内联数据展示。

代码示例

以下示例展示如何在不同编程语言中以编程方式将CSV转换为Markdown表格，每个示例均可生成有效的GFM表格。

JavaScript (Node.js)

const csv = `name,age,city
Alice,30,Berlin
Bob,25,Tokyo`

const [headerLine, ...rows] = csv.trim().split('\n')
const headers = headerLine.split(',')

const separator = '| ' + headers.map(() => '---').join(' | ') + ' |'
const headerRow = '| ' + headers.join(' | ') + ' |'
const bodyRows = rows.map(row =>
  '| ' + row.split(',').join(' | ') + ' |'
)

const markdown = [headerRow, separator, ...bodyRows].join('\n')
// → | name | age | city |
// → | --- | --- | --- |
// → | Alice | 30 | Berlin |
// → | Bob | 25 | Tokyo |

Python

import csv
import io

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,Tokyo"""

reader = csv.reader(io.StringIO(csv_string))
rows = list(reader)
headers = rows[0]

lines = []
lines.append('| ' + ' | '.join(headers) + ' |')
lines.append('| ' + ' | '.join('---' for _ in headers) + ' |')
for row in rows[1:]:
    lines.append('| ' + ' | '.join(row) + ' |')

print('\n'.join(lines))
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |
# → | Bob | 25 | Tokyo |

# With pandas (one-liner)
import pandas as pd
df = pd.read_csv(io.StringIO(csv_string))
print(df.to_markdown(index=False))

package main

import (
	"encoding/csv"
	"fmt"
	"strings"
)

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	headers := records[0]
	var lines []string

	lines = append(lines, "| "+strings.Join(headers, " | ")+" |")
	sep := make([]string, len(headers))
	for i := range sep {
		sep[i] = "---"
	}
	lines = append(lines, "| "+strings.Join(sep, " | ")+" |")

	for _, row := range records[1:] {
		lines = append(lines, "| "+strings.Join(row, " | ")+" |")
	}

	fmt.Println(strings.Join(lines, "\n"))
	// → | name | age | city |
	// → | --- | --- | --- |
	// → | Alice | 30 | Berlin |
	// → | Bob | 25 | Tokyo |
}

CLI (Miller + csvtomd)

# Using Miller (mlr) — convert CSV to Markdown table
mlr --icsv --omarkdown cat data.csv
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |

# Using csvtomd (pip install csvtomd)
csvtomd data.csv

# Using pandas in a one-liner
python3 -c "
import pandas as pd, sys
print(pd.read_csv(sys.argv[1]).to_markdown(index=False))
" data.csv

常见问题

此工具生成哪种Markdown表格格式？

工具生成GitHub风格Markdown（GFM）表格。该格式以竖线字符作为列分隔符，并在表头与正文之间插入一行短划线（---）。GFM表格受到GitHub、GitLab、Bitbucket、Notion、Obsidian、Hugo、Jekyll以及大多数Markdown渲染器的支持。

我可以控制Markdown输出中的列对齐方式吗？

标准Markdown表格语法支持通过在分隔符行添加冒号来设置左对齐（:---）、居中对齐（:---:）和右对齐（---:）。此工具默认生成左对齐列，您可以在转换后手动编辑输出中的分隔符行来更改对齐方式。

工具如何处理包含逗号的CSV字段？

如果CSV字段包含分隔符字符，该字段应按RFC 4180规范用双引号括起来。工具在解析时会去除外层引号，并在Markdown单元格中输出纯文本值。竖线分隔的Markdown格式不要求对逗号进行引用处理。

转换有行数或列数限制吗？

工具本身不设置硬性限制。转换在浏览器中运行，性能取决于您的设备。在现代硬件上，数千行的表格可在一秒内完成转换。对于超大文件（10万行以上），建议使用Miller等命令行工具。

如果CSV没有表头行会怎样？

Markdown表格需要表头行。如果CSV没有表头，工具会将第一行数据作为表头。您可以在粘贴前为CSV添加表头行，或在转换后编辑Markdown输出的第一行。

可以将制表符分隔（TSV）数据转换为Markdown吗？

可以。工具自动将制表符识别为分隔符，直接粘贴TSV数据即可，转换方式与处理逗号分隔输入相同。如果自动检测结果与数据不符，也可手动选择分隔符。

Markdown表格如何处理竖线等特殊字符？

单元格中的字面竖线字符会破坏表格结构。在Markdown中，需用反斜杠转义：\|。从CSV转换时，工具会自动转义单元格值中的所有竖线字符，确保输出表格正确渲染。