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 时:只转换第一个工作表,或转换所有工作表(ZIP 中每个工作表一个 CSV,或 JSON 中每个工作表一个键)。
新电子表格中工作表标签的名称,最多 31 个字符。
对象数组会为每一行使用列名作为键;数组的数组更紧凑,并把表头作为第一个数组。
包裹所有行的外层元素名称;每一行会成为其中的一个 <row>。
用于 CREATE TABLE 和 INSERT 语句。只能使用字母、数字和下划线。
不同数据库的引号和列类型略有差异;请选择您要导入的数据库。
把日期单元格统一改写为一种格式。ISO (2026-10-18) 对数据库和代码最稳妥;保持原样则保留源文件中的显示方式。
使用方法
- 1
上传CSV
添加 .csv、.tsv 或带分隔符的 .txt 文件,一次最多 20 个,每个不超过 95 MB。自动检测可识别逗号、分号、制表符和竖线。
- 2
确认表头
首行为表头默认开启,第 1 行会成为表格标题行。如果文件第一行就是数据,请在高级设置中关闭它。
- 3
转换并粘贴
点击转换为 Markdown 表格,打开生成的 .md 文件,把表格粘贴到 README、Pull Request、Issue 或笔记中。
如何把 CSV 文件转换成 Markdown 表格?
上传 CSV 后点击转换为 Markdown 表格。第一行会成为表头,下方会加入一行短横线,其余每一行都会变成用竖线分隔单元格的数据行。
开发者为什么要把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 和合并请求中渲染相同的管道表格。 | — |
| Obsidian | 在阅读视图中显示管道表格,并在实时预览中提供表格编辑功能。 | — |
| Jupyter | Notebook 中的 Markdown 单元格会在代码旁渲染管道表格。 | — |
| CommonMark | 核心规范没有表格语法;渲染器需要表格扩展。 | commonmark.org |
CSV与Markdown格式要点
CSV
逗号分隔值
CSV 是一种用于表格的纯文本格式,每一行是一条记录,列之间用逗号分隔。它从计算机早期就开始使用,RFC 4180 对其作了说明,不过许多变体使用分号或制表符,文本编码也各不相同。几乎所有电子表格、数据库和分析工具都能导入和导出 CSV,因此它是在系统之间传输数据的默认格式。CSV 只保存数值,不包含公式、格式、多个工作表或数据类型。
- 压缩方式
- –
- 透明度
- –
- 动画
- –
- 发布年份
- –
MD
Markdown
Markdown 是 John Gruber 于 2004 年创建的轻量级标记语法。它使用纯文本符号,例如用 # 表示标题、用 * 表示强调、用 - 表示列表,这些符号在原始文本中依然易读,也能干净地转换为 HTML。它是 README 文件、文档、维基、笔记应用和许多静态网站生成器的标准。它有多种方言,例如 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 表格。如果数据原本是 JSON,JSON 转 HTML 页面已预先选好该输出。