Markdown 表格写出来很好看,但碰到下面这 5 个场景就开始抓狂——

  • 写完一张表格想塞进 Excel 给财务,Markdown 的 pipe 语法全乱
  • Excel 里导出的 CSV 粘到 Markdown 编辑器里,所有逗号都跑出来,整行变成一坨
  • 跨语言项目里,英文逗号 vs 中文逗号做分隔符,来回切换裂开
  • 表格里某个 cell 含逗号或换行,CSV 一导就错位
  • 要把多个 Markdown 表格批量转成 CSV 给团队成员用

10 年前这事只能 Google 搜”markdown to csv online”,大部分工具要求上传你的文件。今天教你的方法完全本地——文件不出浏览器,零上传,5 分钟看完立刻能上手。

30 秒总览

Markdown 表格 ↔ CSV 的核心就两件事:

  1. 解析 — 读 Markdown 的 pipe 分隔,或读 CSV 的逗号/分号/制表符分隔,识别引号转义。
  2. 发射 — 写回对端格式,保留对齐标记、引号模式、换行符。

技术门槛听起来低,实际操作有 4 个隐藏的坑:列数不一致报错、引号嵌套炸掉、不同分隔符(Locale 问题)、空白 cell 字符串 vs null。这 4 个坑下面都讲清楚怎么避。

5 个真实场景

场景 1:周报 Markdown 表格 → 给老板的 CSV

典型输入: 你项目周报里写了一张 5 行表格,老板要 Excel 打开 → CSV。

操作: 用 Markdown 表格 ↔ CSV 工具的 Markdown → CSV 模式,整张表粘到左边 pane,点 Convert。右边 pane 出来 CSV,点 Download 拿到 weekly-2026-w27.csv。

坑: 表格里有 cell 内容含逗号(比如 “李四, 张三” 写在同一格)—— 工具会自动用引号包起来,CSV 输出 "李四, 张三"。Excel 打开这是 1 个 cell,不是 2 个。这正是 RFC 4180 标准要求的行为。

场景 2:Excel 导出的 CSV → 粘进 Markdown 文档

典型输入: 老板给你 finance-2026q2.csv(可能用 , 或 ; 分隔,看 Locale),要粘到你的 Markdown 周报里。

操作: 切换到 CSV → Markdown 模式,粘 CSV 到左边,默认 delimiter 选对。点 Convert,右边出来 GFM pipe table。

坑: Locale 影响 CSV 分隔符。美国/中国默认 ,(逗号),德国/法国 CSV 用 ;(分号)。我们的工具高级选项里有显式 delimiter 选择,首次使用先确认分隔符,不然 100 列数据会塌成 1 列或解析报错。

场景 3:多语言项目里的 CSV 处理

典型输入: 你项目支持 zh / en / ja 三语,翻译文件 (.po、i18n JSON) 跟 CSV 表格互换。

操作: 大多数 i18n 工具链默认用 tab( )做分隔符。我们的工具高级选项里可切到 Tab。

坑: CSV 没有”标准”分隔符。pandas.read_csv() 默认 ,,Google Sheets 导出 ,,Excel 中文版导出可能 , 也可能 ;(看 Windows 系统区域)。永远先验证分隔符——用文本编辑器打开 CSV 看第一行的列数,再对应。

场景 4:CSV 里的 cell 含换行或引号

典型输入: 你有些 cell 内容是多行(比如产品描述里有换行),或含英文双引号 "。

操作: 工具默认 quote 模式 auto 会自动用引号包起来,内部双引号写两个 ""(RFC 4180 标准)。

坑: 很多手写的 CSV 工具不遵守 RFC 4180。如果你用了某个老旧脚本生成的 CSV,内部引号可能用 "(反斜杠转义)而不是 ""(双引号转义),这就是”不规范 CSV”。我们的工具有 malformedCsv 错误提示告诉你有未闭合引号。

场景 5:批量把 Markdown 文档里的所有表格转 CSV

典型输入: 你有 docs/2025-roadmap.md,里面有 10 张表格,要把每张都转成 CSV 给数据团队用。

操作: 当前 v1 工具一次转 1 张。未来 v2 会支持多表格一次性转(我们已经在内部 spec 里写了,等你下个 batch 的反馈决定优先度)。

坑: v1 限制下要分 10 次操作。多表格文档建议先在文本编辑器里把每张表拆成独立代码块(空行隔开),然后逐个跑工具。

4 个常见坑和避免方法

坑 1:列数不一致

症状: Markdown 表格某行多写了 1 个 cell,另一行少写了 1 个。

避免: 工具会报 unevenColumns 错误,具体到第几行第几列。不要”看起来对”就 Paste 出去——肉眼检查不出来。Markdown 编辑器(VSCode、Obsidian)的 table formatter 插件可以自动修复。

坑 2:引号嵌套

症状: CSV 里 "He said ""Hello"" yesterday" 这种,内部是字面量 ".

避免: 这是 RFC 4180 标准,我们的工具正确处理。手写 CSV 不要用 "——那不是 CSV 标准,是某些数据库导出工具的方言。

坑 3:Locale 分隔符混用

症状: 你同事发来的 CSV 在 Excel 里看着正常,你文本编辑器打开发现是 ; 分隔,而你工具自动按 , 解析,100 列变 1 列。

避免: 永远第一次打开 CSV 先看 delimiter。文本编辑器打开看第一行非空行,数 , ; 哪个多。我们的工具有自动检测(优先选出现频率最高的字符),但自动检测不是万能——混合时手动指定最稳。

坑 4:空白 cell vs 缺失 cell

症状: CSV 里有 name,,age 这种(中间空 cell),有些 Excel 导出会写成 name, ,age(中间带空格)。

避免: 工具把 ,, 当 null,, , 当 " "(空格字符串)。这两种有本质区别,特别是导入数据库时。我们的工具会保留原样,不自动 trim。

推荐做法

  1. 首次跑先小测 — 拿一张 5 行的表格试一下,确认 delimiter / 引号模式对了再批量。
  2. 保留原文件 — 转换输出是新的,原 Markdown / CSV 不动。
  3. 域内交给我 — 公司内部文档(/docs/)、项目 wiki、个人笔记都推荐 Markdown;发给财务 / 老板 / 数据团队用 CSV。
  4. 加密敏感表格用别的方式 — CSV 是纯文本,不适合含密码、token、个人信息的表格。这类用我们的 密码生成器 或者专门的加密表格工具。

Markdown 表格 ↔ CSV 的转换,本质上是格式代理,你不需要关心怎么写 parser。我们做了这个工具就是让你专注表格内容,格式转换一秒完成。

试试我们的 Markdown 表格 ↔ CSV 工具 — 默认是 Markdown → CSV 模式,把表格粘进去就开始。