CSV转Markdown表格转换器
将CSV文件转换为Markdown表格语法（`| col1 | col2 |`）。可指定分隔符、是否将首行作为表头，以及列对齐方式（左对齐、居中、右对齐）。转换结果可复制或下载。转换完全在浏览器中进行，不会将数据发送到服务器。
| 分隔符 |
|
|---|---|
| 将首行作为表头 | |
| 列对齐方式 |
|
输入CSV数据后，这里会显示生成的Markdown表格。
CSV行与Markdown表格的对应关系
| CSV的一行 | name,age,city |
|---|---|
| 转换后的Markdown语法 | | name | age | city | |
当首行作为表头使用时，第1行为表头行，第2行为表示对齐方式的分隔行（---），从第3行开始为各数据行。
CSV转Markdown表格转换器是什么
Markdown表格完全由竖线和连字符组成，列数一多，手动敲出来就很麻烦。如果原始数据本来就是CSV——比如从电子表格导出、数据库查询结果或日志文件——就没必要逐个单元格重新输入。本工具会读取CSV内容，自动生成表头行、表示对齐方式的分隔行，以及对应每一行数据的数据行。
由于Markdown表格的每一行必须写在同一物理行内，转换过程中会自动处理一些细节：单元格内的竖线会被转义，避免被误认为列分隔符；带引号的多行单元格中的换行会被替换为半角空格。你还可以为列选择左对齐、居中或右对齐，系统会在分隔行中插入对应的冒号与连字符组合。整个转换过程都在浏览器本地完成，粘贴进来的CSV内容不会离开你的电脑。
如何用CSV生成Markdown表格
- 粘贴CSV数据 将CSV文本粘贴到输入框中。如果是直接从电子表格软件复制的，请将分隔符改为制表符（Tab）。
- 决定首行是否作为表头 如果第一行是列名，请开启"将首行作为表头"，分隔行会自动插入到其下方。
- 选择列的对齐方式 数值列右对齐通常更易读。保持"不指定"则由Markdown渲染器采用其默认方式显示。
- 复制结果并粘贴 复制生成的Markdown，粘贴到README、Issue、PR说明或技术文章中。
用好本工具的小技巧
- 单元格中包含竖线（|）时会自动转义为 \| ，以防止被误认为是列分隔符。
- 用引号括起的多行单元格中的换行会被替换为一个半角空格，因为Markdown表格的每一行必须在物理上占一行。
- 选择"左对齐"、"居中"或"右对齐"后，分隔行中会插入 `:---`、`:---:` 或 `---:`，使GitHub等渲染器按预期的对齐方式显示。
- 搭配姊妹工具"CSV转JSON"和"CSV转SQL"使用，可以将同一份CSV转换为按需选择的三种输出格式。
CSV转Markdown的应用场景
在README中展示表格
先在电子表格中整理好对照表或配置项列表，再转换，就能得到排版整齐的Markdown表格，无需手动调整列宽。
在Issue或PR中展示对比
可以当场把测试结果或候选方案整理成表格。由于仍是纯文本，在diff中也能正常阅读。
为技术文章做数据准备
测得的数据可以直接变成文章中的表格。数值列右对齐能让位数对齐，便于扫读。
整理会议记录和文档
把原本用电子表格管理的清单迁移到用Markdown维护的文档时非常好用。
Markdown表格相关术语
- 表格语法
- 用竖线分隔单元格来表示表格的Markdown写法。不属于最初的规范，是后来作为扩展加入的。
- 分隔行
- 紧跟在表头行之后的连字符行，用于告诉解析器表头到此结束、数据从下一行开始。
- 对齐标记
- 在分隔行的连字符旁加上冒号，用来指定该列是左对齐、居中还是右对齐。
- GFM
- GitHub Flavored Markdown的缩写，是GitHub制定的扩展规范，已成为表格语法事实上的标准。
- 转义
- 在单元格内的竖线前加上反斜杠，防止其被误认为列分隔符的处理方式。
常见问题
闲话 ― 为什么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编写文档的开发者的常见预处理步骤。