CSV 与 Markdown 表格互转工具

CSV 与 GFM Markdown 管道表格双向转换:手写状态机解析 CSV 引号包裹与字段内换行, 支持 4 种列对齐方式(左 / 中 / 右 / 默认)、4 种分隔符(逗号 / 分号 / Tab / 管道符), 自动处理管道符转义。适用于技术文档编写、GitHub README、数据库导出转 Markdown 等场景。 所有转换在浏览器本地完成。

常见问题

什么是 GFM Markdown 表格?

GFM(GitHub Flavored Markdown)表格是 GitHub 扩展的 Markdown 表格语法, 使用管道符 | 分隔单元格,使用 --- 分隔表头与数据行。 一个最简示例:
| 姓名 | 年龄 |
| --- | ---: |
| 张三 | 28 |
分隔行中的冒号 : 用于指定列对齐方式::--- 左对齐、 :---: 居中、---: 右对齐、--- 默认对齐。 GFM 表格被 GitHub、GitLab、Notion、VS Code 等主流工具广泛支持。

CSV 中的引号包裹和转义如何处理?

本工具使用手写状态机解析 CSV,完整支持 RFC 4180 规范:
引号包裹:字段用双引号 " 包裹时,内部的分隔符、换行符不作为分隔符处理。 例如 "北京,上海",28 会被解析为两个字段:"北京,上海" 和 "28"。
引号转义:字段内的双引号用两个连续双引号 "" 表示。 例如 "他说""你好""",3 会被解析为 "他说"你好"" 和 "3"。
字段内换行:引号包裹的字段可以包含换行符,不会被当作行结束。 这对于多行文本字段(如地址、描述)非常重要。

Markdown 表格中的管道符如何转义?

Markdown 表格使用 | 作为单元格分隔符。如果单元格内容本身包含 |, 需要转义为 \|,否则会被误认为单元格边界。
CSV → Markdown 方向:工具自动将单元格中的 | 转义为 \|
Markdown → CSV 方向:工具自动将 \| 还原为 |
例如 CSV 字段 "a|b" 转为 Markdown 后为 "a\|b", 反向转换时正确还原。注意:Markdown 表格不支持单元格内换行,含换行的 CSV 字段会被合并为单行。

列对齐方式有什么影响?

GFM 表格的分隔行可以指定列对齐方式,影响表格在某些渲染器中的显示效果:
左对齐:---):列内容左对齐,适用于文本列
居中:---:):列内容居中对齐,适用于标题或短文本
右对齐---:):列内容右对齐,适用于数字列(金额、数量、百分比)
默认---):由渲染器决定,通常为左对齐
注意:对齐方式仅影响显示,不影响数据内容。并非所有 Markdown 渲染器都支持对齐方式 (如部分博客平台会忽略冒号),但 GitHub、GitLab、VS Code 等主流平台均支持。

这个工具和 CSV/JSON 互转工具有什么区别?

两个工具专注于不同方向:
CSV / JSON 互转:专注于数据格式转换(CSV ↔ JSON),支持嵌套对象展平、 智能类型推断(数字 / 布尔 / null 自动识别)、Excel 兼容下载。适用于数据导入导出、API 对接场景。
CSV 与 Markdown 互转:专注于文档格式转换(CSV ↔ Markdown 表格), 支持列对齐方式、管道符转义、GFM 表格语法。适用于技术文档编写、README 表格、博客内容迁移场景。
两者互补:前者处理数据结构,后者处理文档呈现。例如从数据库导出 CSV 后, 可先用 CSV/JSON 互转做数据清洗,再用本工具转为 Markdown 表格写入文档。

这个工具适合哪些使用场景?

GitHub README 编写:将 Excel / CSV 数据转为 Markdown 表格写入 README;
技术博客文档:将数据库查询结果或 Excel 表格转为 Markdown 表格;
数据库导出转文档:SQL 客户端导出 CSV 后转为 Markdown 表格;
Markdown 表格数据提取:从 Markdown 文档中提取表格数据转为 CSV 供程序处理;
Wiki / 文档迁移:将 Confluence、Notion 导出的表格数据在 CSV 与 Markdown 间转换;
数据校对:将 Markdown 表格转为 CSV 后在 Excel 中校对,再转回 Markdown。

数据会上传到服务器吗?

不会。本工具完全在浏览器内运行,所有 CSV 解析、Markdown 表格生成与转换由 JavaScript 在你本地执行, 不会发送任何输入文本或转换结果到服务器。全程零网络请求,可离线使用。