功能介绍
在技术博客、开源项目的 README、产品文档中,Markdown 表格是最常见的数据呈现方式。与纯文本或截图相比,Markdown 表格可以被搜索、被复制、被其他工具再次解析,对作者和读者都更友好。
但手写 Markdown 表格非常繁琐,需要维护每一列的分隔符与对齐符号,任何一处错位都会导致渲染异常。DataFmt 的 CSV 转 Markdown 工具让您可以直接把来自 Excel、Google Sheets、数据库查询结果的 CSV 文本粘贴进来,一键生成规范的 Markdown 表格。
我们会自动对字段中的管道符 `|`、换行和反斜杠进行转义,确保生成的 Markdown 在 GitHub、GitLab、语雀、Notion、Obsidian 等主流平台中都能正确渲染。
使用步骤
- 把 CSV 文本粘贴到左侧输入区,或上传一个 .csv 文件。
- 若第一行是表头,保持「首行为表头」处于开启状态(默认开启)。
- 点击「转换」按钮,右侧即出现规范的 Markdown 表格。
- 点击「复制」按钮粘贴到您的文档中,或使用「下载」按钮保存为 .md 文件。
典型用例
- 将查询结果、日志摘要写入项目 README 的「Benchmark」或「兼容性」表格。
- 在产品需求文档中嵌入 API 响应字段说明表。
- 在团队知识库中用 Markdown 替代截图,保证内容可搜索、可复制。
注意事项
- 本工具输出的表格列默认左对齐;若需要居中或右对齐,请在生成后手动将分隔行的 `---` 改为 `:---:` 或 `---:`。
- 字段中的 `|` 会被转义为 `\|`,换行会被转换为 `<br>`,以保证渲染正确。
- 过长的字段不会换行到多行表格,仍会保持在一个单元格中。
常见问题
支持多种 Markdown 方言吗?
输出采用最通用的 GFM(GitHub Flavored Markdown)表格语法,GitHub、GitLab、语雀、Notion、Obsidian、VS Code 预览均能正确渲染。
如果没有表头怎么办?
请关闭「首行为表头」选项,我们会自动生成 Column 1、Column 2 … 的占位表头,以满足 Markdown 表格必须包含表头行的语法要求。
为什么我的数字被当成了字符串?
Markdown 表格本身没有类型概念,所有单元格都是文本。如果您希望进行计算,建议使用 CSV → JSON 工具获得结构化数据后再处理。
如何让某一列右对齐?
在生成的 Markdown 中找到第二行分隔符(例如 `| --- |`),将该列对应的分隔符改为 `---:`(右对齐)或 `:---:`(居中)。
表格会不会因为内容过长在移动端溢出?
这取决于承载 Markdown 的平台。大多数平台会给表格加横向滚动条;如遇到异常,可考虑精简列数或拆分为多张表。