CSV 转 Markdown 表格
在浏览器中即时将 CSV 转换为 Markdown 表格。支持引号字段,第一行作为表头,可选择左对齐、居中或右对齐。在浏览器中处理,数据不上传。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
Markdown 表格语法
Markdown 表格由表头行、分隔行和数据行组成,竖线符(|)分隔列。
| 姓名 | 年龄 | 城市 |
| :---- | :--- | :------- |
| Alice | 30 | 纽约 |
| Bob | 25 | 伦敦 |
分隔行控制对齐::--- = 左对齐,:---: = 居中,---: = 右对齐。
把接口字段说明转成表格
写接口文档时,字段说明常先在表格软件里整理,再导出 CSV 贴进 README。下面这份字段表的“说明”列里有竖线,也有加了引号的全角逗号:
字段,类型,必填,说明
status,int,是,0 正常 | 1 禁用
nickname,string,否,"昵称,最多 20 个字"
created_at,string,是,
| 字段 | 类型 | 必填 | 说明 |
| :----------- | :------- | :---- | :------------- |
| status | int | 是 | 0 正常 \| 1 禁用 |
| nickname | string | 否 | 昵称,最多 20 个字 |
| created_at | string | 是 | |
- “说明”里的
|写成了\|,渲染后仍是一个单元格,显示为竖线。 - 引号里的全角逗号原样保留。全角逗号本来就不是分隔符,这里不加引号结果也一样。
created_at那一行以逗号结尾,说明为空,渲染为空单元格。- 列宽按字符个数补空格。一个汉字在等宽字体里占两格,所以源码里含中文的列看起来没对齐,渲染出来的表格不受影响。
右对齐的数字列
对齐方式选“右对齐”:
product,price,units
Widget,9.99,150
"Gadget, large",24.99,42
Cmd|Ctrl+C,1,2
| product | price | units |
| --------------: | ------: | ------: |
| Widget | 9.99 | 150 |
| Gadget, large | 24.99 | 42 |
| Cmd\|Ctrl+C | 1 | 2 |
"Gadget, large" 的引号被去掉,逗号留在单元格里。分隔行比其他行宽,渲染器会忽略这一点。对齐方式对所有列生效,文字列也跟着右对齐。
全角逗号与制表符
用中文输入法录入时容易打出全角逗号,它不是分隔符:
姓名,部门
王芳,研发
| 姓名,部门 |
| :------ |
| 王芳,研发 |
整行成了一列。从 Excel、WPS 或 Google 表格直接复制的内容是制表符分隔的,同样只有一列。先替换成半角逗号,或把表格另存为逗号分隔的 CSV 再粘贴。
竖线与引号
第二行的竖线已经转义过,第三行字段中间有一个英寸符号:
写法,含义
a|b,a 或 b
a\|b,已转义的竖线
5" 管,英寸符号
| 写法 | 含义 |
| :----- | :------- |
| a\|b | a 或 b |
| a\|b | 已转义的竖线 |
| 5" 管 | 英寸符号 |
普通的 | 补上了反斜杠,已经是 \| 的保持不变,两行渲染后都显示 a|b,单元格不会被切开。5 后面的 " 不在字段开头,按普通字符留在单元格里。
哪里能渲染 Markdown 表格
GitHub、GitLab(含极狐 GitLab)的 README、Issue、PR 和 Wiki 都能渲染这种表格语法(GFM 规范:表格)。表格是扩展语法,不带扩展的 CommonMark 会把它显示成普通文本。Docusaurus、MkDocs、VitePress 等静态站点生成器都支持 GFM 表格。需要 JSON 而不是表格时,请用 CSV JSON 互转工具。
限制
- 只认半角逗号。 制表符、分号、全角逗号都不是分隔符,有些地区的 CSV 用分号分隔,同样会变成一列。
- 比表头长的行会补列。 表格的列数取最长的那一行。没有表头的列按位置命名为
Column N(第 4 列为Column 4),状态栏会列出补上的列。比表头短的行补空单元格。 - 所有列用同一种对齐。 只想让数字列右对齐时,复制后手动改分隔行,例如
| :--- | ---: | ---: |。 - 单元格里的换行变成空格。 Markdown 表格单元格不能换行;渲染器允许 HTML 时可以手动写
<br>。 - 不做格式处理。 单元格文本原样输出,
*、_等字符仍可能被当作 Markdown 强调。 - 竖线转义规则与 Markdown 表格生成器 相同。 只有前面是偶数个反斜杠的竖线才补一个反斜杠,所以单元格里原本就是
\|时保持\|,渲染后显示为|;想显示反斜杠本身,在 CSV 里写\\|。这样 GitHub 和 micromark 系的渲染器(remark、MDX、Astro)都不会切开单元格。 - 只有字段开头的双引号算引号。 没加引号的字段里的
"是普通字符,5" 管原样保留。引号字段一直没有闭合时,转换会停止,并报出引号开始的行号。
FAQ
支持哪些 CSV 格式?
逗号分隔、按 RFC 4180 规则加引号的 CSV:引号字段里可以有逗号、换行和两个连写的双引号("")。行尾可以是 LF、CRLF 或 CR,开头的 UTF-8 BOM 会被去掉。制表符和分号不是分隔符。
列对齐是如何工作的?
随时可以切换左对齐、居中或右对齐,当前表格会立即重新生成。分隔行对所有列统一写成 :---、:---: 或 ---:,Markdown 渲染器据此对齐单元格。想让各列对齐方式不同,复制后手动改分隔行。
第一行会成为表头吗?
会。第一行固定作为表头,放在分隔行上方。后面的行字段比表头多时,表格会按位置补上名为 Column N 的列,状态栏会列出补上的列。
数据会上传到服务器吗?
不会。表格在浏览器标签页里生成,CSV 不会发送到服务器,也不会保存到浏览器存储。改完输入框内容并移开焦点、或点击对齐方式时,页面统计会记录一次使用事件(只含工具名和动作 convert),不包含 CSV 或表格内容。
可以直接粘贴到 GitHub 或 GitLab 吗?
可以。输出使用 GitHub Flavored Markdown(GFM)的表格语法,GitHub、GitLab 的 README、Issue、PR 和 Wiki 都能渲染。不支持表格扩展的渲染器会把它显示成普通文本。