这是什么
手写 Markdown 表格很麻烦:每行都要竖线,第二行要写横线,手动对齐列更是费时间。这个工具把 CSV 或 TSV 数据转换成 GitHub Flavored Markdown 表格,可以直接粘贴到 README、Pull Request、Issue、Wiki 页面或任何使用 Markdown 的文档里。
CSV 会被正确解析,带逗号的引号字段、双写的引号和多行单元格都能处理。输出会补齐空格,让各列在纯文本里也对得整齐,以后阅读和修改都方便。
怎么用
- 粘贴 CSV 或 TSV,上传
.csv或.tsv文件,或点 示例。 - 选择 对齐方式:默认、左对齐、居中、右对齐,或 数字右对齐(只含数字的列右对齐)。
- 如果第一行是列名,保持 第一行是表头 开启;否则表头会是 Column 1、Column 2 等。
- 如果想要不补空格的紧凑行,关闭 列宽对齐。
- 复制表格或下载成
.md文件。
单元格比表头少的行会用空单元格补齐,所以生成的表格始终有效。
示例
下面这段 CSV:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier
选择 数字右对齐 后会变成这个 Markdown 表格:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |
引号字段里的逗号留在单元格中,竖线被转义,数字列标记为 --:,渲染时右对齐。
小提示
- 第二行的对齐标记(
:--、:-:、--:)决定渲染后每列的对齐方式。 - 单元格里的行内 Markdown,例如
**粗体**、行内代码或链接,会原样保留,大多数查看器都会渲染。 - 很宽的表格在小屏幕上不好读,可以考虑把列拆成几个表格。
- 想生成 HTML 表格,或把 JSON 数组转成 Markdown 表格,可以用下面的相关工具。
常见问题
› 生成的是哪种 Markdown 表格?
GitHub Flavored Markdown(GFM)的竖线表格,GitLab、Bitbucket、Notion、Obsidian、Docusaurus、MkDocs 和大多数静态网站生成器也都支持。纯 CommonMark 没有表格语法。
› 单元格里的竖线和换行怎么处理?
竖线会结束单元格,所以写成 \|。表格的一行里不能换行,所以换行会变成 <br> 标签,GitHub 和大多数渲染器会把它显示成换行。
› 为什么中文、日文、韩文的列也能对齐?
开启「列宽对齐」时,按显示宽度补空格:东亚全角字符算两列,所以在等宽字体的编辑器里原始 Markdown 也是对齐的。渲染后的表格无论是否对齐都一样。
› 可以转换从 Excel 或 Google 表格复制的内容吗?
可以。从表格软件复制的单元格用 Tab 分隔,分隔符会自动识别,也可以手动选择 Tab。