CSV 怎么转成 Markdown 表格？列数、竖线与对齐

把表格贴进 Markdown 文档，最麻烦的是手画那行分隔线和竖线。粘贴数据、转换一次，就能得到可以直接提交的表格源码。

什么时候需要 Markdown 表格

提交 issue 时贴一份复现步骤表、在 README 里放参数对照、在 PR 描述里列改动清单，用表格比用列表清楚得多。但从 Excel 复制过来是一堆制表符，手动加竖线既慢又容易错位。

写文档、维护 wiki、给博客加一张价格表，本质上都是同一件事：把已经整理好的表格数据转成 Markdown 语法，不用再一行行数竖线的位置，省下来的时间可以放在内容上。

工具按行处理，空行会被丢掉，每行按制表符或逗号切分。第一行被当作表头，后面每一行生成一行表格，分隔行固定是三个短横线。所以数据的第一行必须是列名，不能是数据本身。

三个注意点。第一，单元格里如果有竖线，会直接破坏表格结构，需要先替换成其他符号或转义写法。第二，各行列数不一致时，工具不会补齐，少的那行会缺格。第三，单元格里带换行会让解析错位，先把内容合并成一行。

生成的分隔行是三个短横线，也就是默认对齐。Markdown 支持用冒号指定对齐：左边加冒号是左对齐，两边都加是居中，右边加是右对齐，但本工具不生成这些写法，需要转换后手动改分隔行。

列宽不需要处理：Markdown 源码里各列长短不齐，渲染时会自动对齐，不必为了好看补空格。它也不支持合并单元格、表头分组、单元格内多行这些复杂结构，遇到这类表格只能手动改写成 HTML 或拆成多张表。

表格能设置居中或右对齐吗？

工具本身不生成对齐标记，但 Markdown 支持：分隔行写成冒号加短横线是左对齐，两边都加冒号是居中，只在右边加冒号是右对齐。转换后手动改这一行即可，多数渲染器都认这种写法。

单元格里有竖线怎么办？

竖线是 Markdown 表格的列分隔符，直接出现会让后面的内容被当成新列。可以在竖线前加反斜杠转义，或换成 HTML 实体，也可以先把竖线替换成斜杠、顿号之类的符号，再转换。

从 Excel 复制过来是制表符，能识别吗？

能。工具同时支持制表符和逗号分隔，从 Excel 或表格软件直接复制粘贴通常就是制表符，不需要先导出 CSV。注意第一行会被当成表头，复制时不要把标题行漏掉。