Markdown 表格生成

把 Excel、CSV 或制表符分隔的文本粘进来,一键转成对齐整齐的 Markdown 表格。

支持从 Excel 直接复制(制表符)、CSV(逗号)与 Markdown 竖线表格,带引号的字段会按 CSV 规则解析

输出选项
行数0
列数0
识别到的分隔符—

    

使用说明

  1. 从 Excel 或飞书表格复制一块区域直接粘贴,制表符会被自动识别。
  2. 也可以粘贴 CSV 文本;字段里含逗号时用英文引号包起来,引号内的逗号不会被拆开。
  3. 选择对齐方式,左对齐适合文字,右对齐适合金额与数字,居中适合状态列。
  4. 取消「首行作为表头」会生成一行空表头,因为 Markdown 表格必须有表头行。
  5. 点「复制表格」拿到源码,粘进 README、文档或笔记软件即可渲染。

常见问题

单元格里有竖线怎么办?
竖线是 Markdown 表格的列分隔符,内容里的竖线会自动转义成 \|,渲染后仍显示为竖线。若表格里竖线特别多,建议换成制表符或逗号输入,输出时统一转义。
为什么一定要有表头行?
Markdown 的表格语法要求第二行是分隔行,第一行固定当表头。取消首行作表头时,页面会生成一行空白表头占位,渲染出来顶部没有文字,但结构仍然合法。
中文列宽对不齐是 bug 吗?
不是。补空格按字符数计算,一个汉字在东亚洲字宽下通常占两个英文字符的宽度,所以源码里看起来参差。渲染后的表格由浏览器排版,不会受影响。介意源码对齐时关掉补空格选项即可。
支持多大的表格?
几万字符没有问题,解析与生成都在本地完成。超大表格(数千行)建议先在表格软件里精简列,Markdown 本身不适合承载过宽的数据。

使用步骤

  1. 从表格软件复制

    在 Excel、飞书或 Notion 里选中区域复制,直接粘进输入框。列之间是制表符,页面会自动识别,不用手动转换。

  2. 也可以粘 CSV

    逗号分隔的文本同样支持。字段里含逗号时用英文双引号包住,引号内的逗号与换行不会被拆开。

  3. 选对齐方式

    文字列用左对齐,金额与数字用右对齐,很短的状态列可以居中。不指定时渲染结果由阅读器决定。

  4. 处理表头

    默认首行作表头。取消勾选会生成一行空表头,因为 Markdown 语法要求分隔行之前必须有一行表头。

  5. 复制源码

    点「复制表格」拿到完整的 Markdown 源码,粘进 README、文档或笔记软件即可渲染成表格。

工具详细介绍

Markdown 表格写起来很啰嗦:每行要补竖线,第二行要写分隔符,列宽还得手动对齐,改一个字段就要整段重排。从表格软件复制过来的内容本来是制表符分隔的,手动加竖线既慢又容易漏。把这段机械劳动交给工具,粘一次就能拿到结构完整、源码可读的表格。写文档、整理 issue、更新 README 都能用上。团队里每个人都按同一套格式写,文档看起来会整齐很多。

本页先按分隔符把文本切成二维数组,再逐格转义竖线与换行,最后按每列最大宽度补空格。表头、对齐方式与补空格都可以单独开关,输出即时更新。带引号的 CSV 字段会按标准规则解析,字段里的逗号与换行不会被拆开。解析与生成全部在浏览器里完成,表格内容不会上传,适合处理带内部数据的表格,刷新页面即清空,不会留下记录。

原理与背景

Markdown 表格属于 GFM 扩展,原始规范里没有。语法要求第一行是表头,第二行是分隔行,每个单元格用竖线隔开。分隔行的冒号决定对齐:左侧冒号左对齐,右侧冒号右对齐,两侧都有冒号居中。列数不必严格相等,渲染器会按表头补齐,但缺列的数据会错位,所以生成前最好确认每行列数一致。分隔行至少要有三个短横线,少了某些渲染器会直接不识别。

表格的宽度由阅读器决定,源码里的空格只影响可读性,不影响渲染。中文字符通常占两个英文字符宽度,按字符数补空格会让源码看起来参差,这是正常现象。真正需要注意的是竖线与反斜杠:单元格里的竖线必须转义,否则会被当成列分隔符;反斜杠也要转义,不然会吃掉后面的字符。单元格里的换行同样要处理,多数渲染器只认单行内容。

典型使用场景

  1. 写 README 的配置表

    项目文档要列环境变量、默认值与说明。在表格软件里整理好三列,复制粘贴生成 Markdown,再贴进 README,比逐个敲竖线快得多,也不容易错位。以后加一行变量,回到表格里补完重新生成即可。

  2. 整理选型对比数据

    选型时对比几个方案的价格、并发与限制。先用表格软件算清楚,再转成 Markdown 贴进文档或 issue,评审时所有人看到的是同一张表,不用来回截图,数字改动也有迹可循。

  3. 把 CSV 报告转进周报

    导出的 CSV 有十几列,周报只需要其中三列。在表格软件里删掉多余列再复制,生成表格后贴进周报,数据来源清楚,格式也统一。下周换一份数据,重复一次即可。

使用技巧

  • 给文档写表格时先想清楚列,超过六列的 Markdown 表格在手机上几乎无法阅读,能拆就拆。
  • 数字列统一右对齐并保留相同小数位,读者扫一眼就能比较大小。
  • 表格里的换行用 br 标签代替,Markdown 单元格不能直接放多行文本。

注意事项

  • 列数不一致导致错位

    某行少一个字段时,后面的数据会整体左移一格,渲染出来对不上表头。生成前先检查每行列数,缺的补空值,别让读者自己猜。表格软件导出的空单元格容易被忽略,粘贴后扫一眼行尾。

  • 单元格里直接写竖线

    未转义的竖线会被当成列分隔符,一行被切成两行。工具会自动转义成反斜杠加竖线,手工改源码时也要记得补上,否则表格结构会整段乱掉,排查起来很费时间。

  • 表格过宽

    十几列的表在手机上与代码块里都会横向滚动,读者很难看全。把长表拆成两张,或把次要列移到正文说明,比硬塞进一张表更清楚,维护时也更省心。

相关工具