Markdown 表格生成器 - 在线表格制作

1. 两种输入模式

对齐空格主要给人眼校对；渲染器真正依赖的是：每行列数一致的管道符，以及表头下方的分隔行（--- / :---: / ---:）。先保证结构正确，再微调空格。

1. CSV 模式：粘贴逗号、分号或制表符分隔的文本，指定分隔符后即时生成表格源码。
2. 编辑器模式：在格子里直接改单元格，用加减行列按钮扩展结构。
3. 选择对齐方式与「首行是表头」，复制输出到 .md、Issue 或 Pull Request。

2. 对齐与表头开关

GFM 对齐语法写在分隔行：左侧冒号、两侧冒号、右侧冒号分别对应左/中/右。本工具按当前选择批量生成，避免手工数冒号。

• 左对齐适合名称与说明列；右对齐适合数字与金额；居中适合短状态标签。
• 整表共用一种对齐；若需要「名称左、数字右」，生成后再手工改分隔行里的冒号。
• 关闭「首行是表头」时，首行也会作为数据输出——适合本来就没有表头的矩阵。

3. 从表格软件粘过来

从电子表格复制时常混入制表符、区域小数点或千分位空格。先确认分隔符设置；宽表在手机预览会换行难看，可拆成两张表，或在正文里链到 CSV 附件。单元格内若必须出现竖线字符，请转义或改用 HTML 表格片段，否则管道语法会被拆断。

4. 下游互转与预览

对比表、版本矩阵、权限矩阵是文档里的高信号区块。生成后补一行表意说明（这张表在回答什么问题），比裸表更容易被评审和检索扫描。

• markdown-table-to-json / csv：把文档表变成程序可读结构。
• markdown-preview：确认渲染，尤其是含链接、代码反引号或表情的单元格。
• html-table-to-markdown：从网页或 Wiki 表格迁到文档站。

5. 常见错误

若渲染结果「少一列」，优先检查是否有单元格内未转义的 |，而不是怀疑对齐空格。

• 漏分隔行会导致部分渲染器把第二行当普通数据。
• 列数不一致时输出会错位——粘贴 CSV 后先数分隔符。
• 本地会话会记住草稿，换浏览器或清站点数据后不要假设还在。

6. 文档工作流建议

定稿前进版本库；评审里若只改一格数据，优先直接改源 Markdown，而不是重新从表格软件导出整表，以减少无关 diff。需要结构化校验或喂给脚本时，先转到 JSON，再在下游做类型转换。团队可把「表格生成 → 预览 → 互转」写成检查清单，避免口头约定漂移。 对长期维护的版本对比表，把「列含义」写进表上方段落或表注，避免半年后只剩管道符无人解释。若 CI 会检查 Markdown 风格，生成后跑一次文档站点的本地预览，确认主题 CSS 没有把表格撑破侧栏。