JSON转Markdown
将复杂的 JSON 数据转换为嵌套的 Markdown 列表或无边框表格，适合生成文档或笔记。
JSON 转 Markdown
JSON 转 Markdown 工具使用指南
📌 简介
JSON 转 Markdown 工具是一款专为技术文档编写者、产品经理和后端开发者设计的数据整理神器。在对接第三方 API 或整理数据库结构时，复杂的嵌套 JSON 数据往往让人看得眼花缭乱。如果要把这些数据写进开发文档、README 或者 Obsidian 笔记中，纯文本的 JSON 代码块缺乏层次感。本工具可以将 JSON 数据一键转化为结构清晰的 Markdown 嵌套列表或表格，让数据瞬间变成排版精美的文档。
📖 数据结构转换的艺术
JSON 是一种纯数据的机器交换格式，而 Markdown 是富含语义的文档格式。本工具在底层使用递归算法遍历 JSON 树。当您选择“嵌套列表”时，它会将对象的键（Key）加粗，并用缩进表示层级，这对于展示结构多变的 API 响应体非常直观；当您选择“键值对表格”时，它会自动检测某一层级是否只包含简单的键值对，如果是，则将其渲染为 Markdown 的表格，极大地压缩了篇幅。这种层级化的拆解，能让阅读文档的同事一眼看清数据结构。
💼 常见应用场景
- 编写接口文档： 将前后端联调时抓包获取的 JSON 响应，直接转为 Markdown 贴入 Yapi 或 Apifox。
- 知识库整理： 将配置文件（如 package.json）转为可读性极强的笔记。
- 数据汇报： 在向非技术人员展示数据时，用表格代替一堆密密麻麻的代码括号。
⚙️ 使用步骤
- 将需要转换的 JSON 数据粘贴到左侧输入框。
- 选择需要的输出格式（嵌套列表或表格）。
- 右侧会实时生成 Markdown 源码。
- 点击“复制结果”粘贴到您的编辑器即可看到渲染效果。
⚠️ 注意事项
- 当 JSON 数组中包含多个不同结构的对象时，表格模式可能无法完美呈现，建议切换到列表模式。
- 工具会自动对键值进行排版优化，但不会修改原本的键名和数值类型。
❓ 常见问题 (FAQ)
Q: 为什么生成的表格只有一行？
A: 表格模式只适用于对象内部全是简单键值对的情况。如果对象内部有嵌套的数组或对象，工具会自动降级为层级列表以保留完整性。