使用方法
Markdown表格生成器四步:
- 从 Excel、飞书表格或 CSV 里复制数据,直接粘贴进输入框(页面已预置 3 列示例)。
- 「分隔符」默认自动识别;若识别不准可手动选制表符、逗号或竖线。
- 「首行作为表头」默认「是」,第一行会变成 Markdown 的表头行。
- 点「转换」,下方得到表格代码,点「复制 Markdown」拿走。
Markdown表格生成器能解决什么
它解决「手动敲表格分隔线很烦」的问题:
- 写文档:README、Issue、笔记里要放表格,转一下即用。
- 整理数据:把零散数据粘进来,快速得到对齐的 Markdown。
- 避免手误:分隔线那一行的竖线数量最容易数错,交给你自动补。
本页不做的事:不做单元格内换行的转义,也不做表头样式或对齐标记(:-- 等)。
原理和变量
① 用了哪个具体函数:先按行 split(\n),再按分隔符 split 成列,最后把每行用 | 拼接,并在表头后插一行分隔线。
② 关键参数为什么这样取:默认「自动识别」是看首行里哪种分隔符出现最多,制表符优先于逗号,因为从表格软件复制出来的通常是制表符。
③ 遵循哪个标准:输出符合 CommonMark 的表格扩展(GFM)语法:| 列 | + | --- | + 数据行。
④ 输入怎么变成输出:演示的 4 行制表符数据 → 表头「名称/类型/价格」+ 分隔线 | --- | --- | --- | + 3 行数据。
⑤ 边界与阈值:空输入提示;只有一行且设为表头时,输出只有表头与分隔线;各行列数不一致时以表头列数为准,多余列被截断、缺失列补空。
⑥ 常见误用的正确解释:单元格里若自带竖线 | 会破坏表格结构,本页不自动转义;含竖线的数据请改用其他分隔符或先替换。
完整示例
演示输入(制表符分隔,4 行 3 列):
- 第 1 行 名称 / 类型 / 价格 作为表头。
- 第 2~4 行 基础版、专业版、企业版 作为数据行。
- 输出第二行固定为分隔线
| --- | --- | --- |,三列各一段。
最终得到 4 行 Markdown;粘进支持 GFM 的编辑器即渲染成 3 列表格。演示仅作说明。
输入范围与对照表
分隔符与列数处理对照:
| 情形 | 处理 | 说明 |
|---|---|---|
| 自动识别 | 取首行出现最多的分隔符 | 制表符优先 |
| 列为空 | 该列输出空单元格 | 补一个空格 |
| 行比表头短 | 缺失列补空 | 不报错 |
| 行比表头长 | 多余列截断 | 以表头为准 |
| 单元格含竖线 | 不转义 | 建议先替换 |
| 只有表头行 | 输出表头+分隔线 | 无数据行 |
| 空行 | 跳过 | 不产生数据行 |
结果边界和舍入
本工具不涉及数值计算,输出为纯文本。对齐标记(如 :---)默认不生成,全部为左对齐;如需指定对齐,可在得到代码后手动修改分隔线一行。
常见问题
从 Excel 复制过来分隔符是什么?
通常是制表符,本页「自动识别」会优先按制表符解析,一般无需手动选。
第一行一定是表头吗?
可以在「首行作为表头」里选「否」,此时首行也会当作普通数据行,但仍会生成一行分隔线以保证语法正确。
单元格里有逗号会串列吗?
会。若数据本身含逗号,请改用制表符分隔或选择制表符选项,避免误切。
列数不一致会怎样?
以表头列数为准:少的补空、多的截断,不会报错。
能生成表格的 HTML 吗?
本页只输出 Markdown,不输出 HTML。
内容会上传吗?
不会,转换完全在浏览器本地完成。
支持对齐标记吗?
默认左对齐,不自动生成 :-- 之类标记,可复制后手动改。
手机能粘贴吗?
可以,粘贴后点「转换」即可,输出框可长按复制。