UltKit

CSV转Markdown表格转换器

手动输入Markdown表格,每一行都要数竖线和短横线。直接上传CSV,即可得到带表头行和分隔行的表格,可直接粘贴到README、Wiki页面或笔记本中。

数据转换器

或将CSV, TSV, TXT … 文件拖放到此处 ·

单个文件最大 95 MB· 最多 20 个文件· 30 分钟后删除

输出

文件在我们的服务器上处理,并在 30 分钟后删除。

使用方法

  1. 1

    上传CSV

    添加 .csv、.tsv 或带分隔符的 .txt 文件,一次最多 20 个,每个不超过 95 MB。自动检测可识别逗号、分号、制表符和竖线。

  2. 2

    确认表头

    首行为表头默认开启,第 1 行会成为表格标题行。如果文件第一行就是数据,请在高级设置中关闭它。

  3. 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表格示例

输入 CSV:受支持的运行时版本
运行时,版本,状态
Python,3.13,支持中
Python,3.9,停止维护 | 2025年10月
Node.js,22,支持中
输出:值中的竖线已转义的管道表格
| 运行时 | 版本 | 状态 |
| --- | --- | --- |
| Python | 3.13 | 支持中 |
| Python | 3.9 | 停止维护 \| 2025年10月 |
| Node.js | 22 | 支持中 |

转换后的Markdown表格在哪里显示

各平台对Markdown表格的支持情况
机构要求来源
GitHub遵循 GFM 规范,在 README、Issue、Pull Request 和 Wiki 中渲染管道表格。GFM 规范
GitLabGitLab Flavored Markdown 在仓库、Issue 和合并请求中渲染相同的管道表格。—
Obsidian在阅读视图中显示管道表格,并在实时预览中提供表格编辑功能。—
JupyterNotebook 中的 Markdown 单元格会在代码旁渲染管道表格。—
CommonMark核心规范没有表格语法;渲染器需要表格扩展。commonmark.org

CSV与Markdown格式要点

CSV

逗号分隔值

CSV 是一种用于表格的纯文本格式,每一行是一条记录,列之间用逗号分隔。它从计算机早期就开始使用,RFC 4180 对其作了说明,不过许多变体使用分号或制表符,文本编码也各不相同。几乎所有电子表格、数据库和分析工具都能导入和导出 CSV,因此它是在系统之间传输数据的默认格式。CSV 只保存数值,不包含公式、格式、多个工作表或数据类型。

压缩方式
–
透明度
–
动画
–
发布年份
–
CSV 转换器

MD

Markdown

Markdown 是 John Gruber 于 2004 年创建的轻量级标记语法。它使用纯文本符号,例如用 # 表示标题、用 * 表示强调、用 - 表示列表,这些符号在原始文本中依然易读,也能干净地转换为 HTML。它是 README 文件、文档、维基、笔记应用和许多静态网站生成器的标准。它有多种方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等细节上有所不同。任何文本编辑器都能打开 .md 文件。

压缩方式
–
透明度
–
动画
–
发布年份
2004 · John Gruber
MD 转换器

当少量数据需要放进文档时,就会把 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 页面已预先选好该输出。