使用方法
- 选择“转换方向”:CSV 或 TSV 转为 Markdown 表格,或 Markdown 表格转为 CSV。
- 把文本粘贴到“待转换的文本”中。在 CSV 中,第一行是表格的表头。
- 在“列对齐方式”下保留“自动”(数字靠右),或让所有列选择同一个方向。
- 根据转换方向,复制“Markdown 表格”或“CSV”。
Markdown 表格的语法
GitHub Flavored Markdown 表格扩展中的表格由表头行、分隔行和正文行组成。单元格之间用竖线分隔;分隔行每列一个单元格,由短横线组成,两端可选加冒号。GFM 规范规定分隔行的单元格数必须与表头相同。左侧冒号表示左对齐,右侧冒号表示右对齐,两侧冒号表示居中。
正文行的单元格少于表头时,会补上空单元格;多于表头时,多出的单元格会被忽略。单元格中的竖线前要加反斜杠,渲染器才会把它保留在单元格中。
| 表头 | 表头 | 然后 | --- | ---: | 然后 | 正文 | 正文 |
列宽、数字与转义
每列的宽度与其最宽的单元格相同,最小为三个字符,因此填充后的表格每行长度一致。若某列中所有非空单元格都是数字,则该列靠右对齐,便于比较各位数字。宽度按字符计算,因此宽字符可能无法完全对齐。
表格的每一行都必须在一行之内,因此 CSV 单元格中的换行会被写成空格。CSV 的读取遵循常规规则:含有逗号或引号的单元格要用引号括起,其中的引号则要写两次。
- 当“检测”选错分隔符时,请自行选择。若表格软件导出的是分号,请选择“分号”。
- 若 Markdown 很长,而文件大小比原始文本的排版更重要,请关闭“让列对齐”。
示例:商品名称中带竖线的价目表
CSV 的表头为 商品、价格、库存,两行数据为 茶、12.5、40和 咖啡 | 咖啡豆、85、12。单元格“咖啡 | 咖啡豆”转义竖线后宽9个字符,因此商品列宽9;价格和库存的数字靠右对齐,价格列宽4,库存列宽3(每列至少3个字符)。
分隔行中,商品列为 ---------,价格列为 ---:,库存列为 --:。咖啡一行写作 咖啡 \| 咖啡豆,其后的85和12靠右填充。表格有2个数据行和3列。
常见问题
为什么单元格中的竖线需要反斜杠?
竖线是 Markdown 表格的列分隔符,因此单元格中裸露的竖线会开始一个新的列。在竖线前加反斜杠,就能把它保留在单元格中,渲染后的表格只显示一个竖线。
为对齐而添加的空格会改变表格的外观吗?
不会。渲染器会忽略单元格文字两侧的空格,因此表格外观相同。这些填充只是让编辑器中的原始 Markdown 更易读。
为什么数字列要靠右对齐?
数字的末位对齐后更便于比较,因此自动对齐会把数字列放在右侧。只要列中有任何文字,该列就保持原样,靠左。
CSV 单元格中的换行会怎样?
表格的一行必须在同一行内,因此工具会把单元格中的换行写成空格。除该空格外,单元格的文字保持不变。
哪些地方能正确显示 Markdown 表格?
GitHub 以及大多数遵循 GFM 表格扩展的 Markdown 工具都能显示。有些简单的 Markdown 渲染器完全没有表格语法,因此请在发布的地方先行核对。
我粘贴的文本会被发送或保存吗?
不会。表格和 CSV 都在您的浏览器中生成。内容既不会存储,也不会发送到我们的服务器,因此离开页面前请先复制结果。
资料来源
数据和文字最近核对于2026年11月10日星期二。