CSV 转 Markdown 表格

在浏览器中即时将 CSV 转换为 Markdown 表格。支持引号字段,第一行作为表头,可选择左对齐、居中或右对齐。在浏览器中处理,数据不上传。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
列对齐 左对齐、居中或右对齐应用于所有列,并立即更新已有输入的结果。分隔行决定 Markdown 渲染器中的对齐方式。
清空两个面板、状态和等待执行的转换,保留对齐方式。焦点在工具内时,Ctrl+L(Mac 为 ⌘+L)也会清空。
粘贴逗号分隔的 CSV,第一行作为表头。停止输入 0.3 秒后自动更新表格。支持引号字段内的逗号与换行。
复制当前 CSV 输入的全部文本。输入为空时无法复制。
输出为 Markdown 表格。单元格中的竖线会转义,换行变为空格。多出的字段会补为命名列,状态行会列出这些列。
复制生成的完整 Markdown 表格,可用于 GitHub、GitLab 或 Markdown 编辑器。结果为空时无法复制。
Markdown 表格将显示在这里。
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

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 都能渲染。不支持表格扩展的渲染器会把它显示成普通文本。