这个工具用来做什么
Markdown 表格靠竖线和一行分隔符表达结构,列一多就容易错位:少一个 |、分隔行少一列,整张表在渲染时就会塌掉。这里把表格做成可视化网格,结构由工具保证,只专注于内容。
Markdown 表格的结构
一张表由三部分组成:表头行、分隔行、数据行。分隔行用 --- 占位,同时通过冒号位置声明对齐::--- 左对齐,:---: 居中,---: 右对齐。三者的列数必须与表头一致。
源码不要求各列宽度对齐,因为渲染后宽度由内容决定。但对齐后的源码在纯文本里更好读,这个工具默认会补齐空格。
常见坑
- 单元格里有竖线:会被当成列分隔符,必须写成
\|。工具会自动处理。 - 单元格里换行:标准 Markdown 表格不支持多行,想换行要写
<br>。 - 缺少空行:表格前后通常需要空一行,否则部分解析器会把它并入上一段。
- 列数不一致:数据行比表头少列时,多数渲染器会补空单元;多出的列则会被丢弃。
- 表格里放列表或代码块:多数实现不支持块级元素嵌套,复杂内容建议改用列表或拆表。
下一步:生成源码后可以直接粘进「Markdown 预览」看渲染效果,确认列宽与对齐是否符合预期。