GUIDE深度 · Deep dive
CSV 转 Markdown 的坑
CSV 的字段可能包含逗号、引号和换行;直接按逗号 split 会错列。Markdown 又用 | 分列,所以字段里的管道符必须转义。
处理顺序
先按 CSV 规则解析引号字段。
补齐列数,再转义 |。
最后生成表头和分隔行。
检查
每行列数是否一致。
表头是否为空/重复。
预览渲染后是否错位。
常见问题
能保留数字格式吗?
会原样保留字符串;前导零/千分位需自己处理。
需要加表头吗?
Markdown 表格需要分隔行;表头可空但建议有。