DevToolPal
简

CSV 转 Markdown 表格

把 CSV 或 TSV 转换成排列整齐的 Markdown 表格,用于 README、文档和 GitHub Issue。

本地处理,不上传

选项

输入

0 字符 · 0 B

输出

0 字符 · 0 B

这是什么

手写 Markdown 表格很麻烦:每行都要竖线,第二行要写横线,手动对齐列更是费时间。这个工具把 CSV 或 TSV 数据转换成 GitHub Flavored Markdown 表格,可以直接粘贴到 README、Pull Request、Issue、Wiki 页面或任何使用 Markdown 的文档里。

CSV 会被正确解析,带逗号的引号字段、双写的引号和多行单元格都能处理。输出会补齐空格,让各列在纯文本里也对得整齐,以后阅读和修改都方便。

怎么用

  1. 粘贴 CSV 或 TSV,上传 .csv 或 .tsv 文件,或点 示例。
  2. 选择 对齐方式:默认、左对齐、居中、右对齐,或 数字右对齐(只含数字的列右对齐)。
  3. 如果第一行是列名,保持 第一行是表头 开启;否则表头会是 Column 1、Column 2 等。
  4. 如果想要不补空格的紧凑行,关闭 列宽对齐。
  5. 复制表格或下载成 .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。