01
理解选列什么时候重置
首次转换才会生成字段清单。更换 JSON 或切换嵌套策略会重新发现字段并全选，避免旧路径悄悄筛掉新数据。只改对齐或输出格式则保留已经选好的列与顺序。
JSON 工具
JSON 转 Markdown让接口记录成为文档表格
粘贴 JSON 数组，选择要展示的字段，调整列序后核对预览；也可切换为 HTML 表格输出。
JSON 转 Markdown
JSON 输入
在当前浏览器中处理，不上传或保存输入。
表格结果 · Markdown
转换后显示表格预览。
选择与排列输出列
转换后发现字段。修改输入或嵌套策略会重置选列；箭头仅调整输出列顺序。
内容已变化，正在更新结果…
给接口文档补示例时，直接贴一整段响应往往会把关键字段淹没。JSON 转 Markdown 可以把同一批对象排成表格，让名称、状态和说明放在合适的位置；后几条记录才出现的字段也会纳入列清单。
这个在线转换器不会根据第一条记录猜完整结构。你可以保留嵌套对象的上下文，也可以展开对象路径。输出仍是一条对象对应一行，不会因为某个数组有多个元素就把记录复制几遍。
为什么使用 JSON 转 Markdown
先发现所有字段，再决定展示哪些列
JSON 转 Markdown 会按记录顺序扫描字段并取并集。示例中的 score 只出现在第二条记录，仍会成为可选列；取消勾选只是隐藏输出列，向上或向下移动只是改变阅读顺序，都不会改写左侧 JSON。
嵌套信息有两种明确的呈现方式
默认把对象保留为紧凑 JSON，适合在一格里查看完整地址或配置。展开模式把对象叶节点变成路径列，适合横向比较城市等属性。数组始终放在一个单元格里，避免表格行数和原始记录数不再对应。
先检查结构，再交给文档渲染器
02
使用自动刷新或明确执行
自动转换默认开启，停止编辑约 400 毫秒后更新。关闭后可点击转换或按 Ctrl/Cmd + Enter。输入、参数和列顺序只要变化，复制与下载立即禁用，直到得到与当前设置一致的新结果。
03
预览只分页，导出不分页
表格先显示 50 行，可继续每次增加 50 行。切到源码检查转义和表头分隔行；复制与下载始终包含全部记录。切换格式后下载名会变为 table.md 或 table.html，便于识别粘贴目标。
可控制的字段与输出语法
缺失字段与空值分开表达
没有出现的字段显示为空单元格，显式 null 则显示文字 null。数字 0、布尔值 false 不会被当成空值；空字符串仍为空白。这样的表格方便审阅，但不能代替原始 JSON 保存所有类型信息。
表头和内容使用同一套转义
字段名中的竖线与反斜杠也会转义，不只处理数据行。Markdown 强调和链接标记作为文字保留，输入中的 HTML 先编码为实体，再把真正的换行改为生成器自己的 <br>，避免把文字标签误认为可执行内容。
两种格式共用列与对齐设置
Markdown 输出包含必需的表头和分隔行，并用冒号表示左、中、右对齐。HTML 输出是带表头作用域的 table 片段。统一对齐作用于全部选中列，不会按数字类型自动重新判断，也不改变行顺序。
大整数和嵌套数字保留原文
解析器不会先把数字转成 JavaScript 浮点数，因此长标识符、小数尾零、指数写法和负零可以保留。对象展开使用 JSON Pointer 路径，斜杠与波浪号有明确编码，不会把含点号的原始键名混成嵌套路径。
转换前需要知道的边界
- 只接受严格的对象数组
- 请先从接口包装结构里提取目标数组。本页不把单对象自动猜成键值表，也不接收标量数组、JSONL、JSON5、注释或重复键。不提供网址抓取、文件上传和自动修复，语法问题会报告行列位置。
- 展开对象不会拆散数组
- 默认表头保留顶层键名；展开后表头使用 /user/name 这样的路径，键名中的 / 和 ~ 分别写为 ~1 与 ~0。空对象和空数组保留 {} 与 []。不做行展开、数组拼接、转置、去重或表格逐格编辑。
- 不同渲染器的显示仍需核对
- Markdown 表格面向 GFM 扩展；仅支持基础 Markdown 的平台可能不识别表格。禁用内嵌 HTML 时，<br> 的显示也可能不同。目标平台可能修剪单元格首尾空格或合并连续空白，预览不承诺逐字排版一致。 某些平台还会自动把纯文本网址识别为链接，本页预览只显示文字。
- 超过预算会停止，不导出半张表
- 上限为输入 500,000 字符、50,000 个解析节点、深度 100、10,000 条记录、200 个发现列、100,000 个单元格及 2,000,000 个输出字符。空数组、全为空对象或取消全部列会提示无可用列；不会生成看似成功的空文件。
JSON 转 Markdown 常见问题
这个 JSON 转 Markdown 工具会不会上传我的 JSON？
不会。处理在当前浏览器内进行，输入不会被这个工具上传或保存。这里没有通过网址获取接口数据的入口；如果源响应带敏感字段，仍应检查选列后的表格，确认适合放入目标文档。
JSON 转 Markdown 支持多大体量？
除输入 500,000 字符外，还会检查节点、深度、行列数、矩形单元格总数与输出长度。字段稀疏但种类很多的数组，也可能先触发单元格预算。超过任一上限整次失败，不会截断后继续导出。
嵌套对象会不会丢信息？
默认把嵌套对象和数组保存为紧凑 JSON 文本；可选择仅展开对象。信息用于表格展示，不是完全可逆的格式转换，例如空字符串和缺失值都会显示为空。需要还原类型时请保留原文。
JSON 转 Markdown 的输出能直接贴 GitHub/Wiki 吗？
可以用于支持 GitHub Flavored Markdown 表格的地方。其他 Wiki 的语法和 HTML 策略不一定相同，尤其要核对多行单元格的 <br>。如果目标编辑器接受 HTML，可以选择导出 HTML 表格片段。
如何在 Markdown 中使用 JSON？
若要逐项比较对象数组，用表格比较直观；如果要展示整个配置或保留精确结构，更适合在文档代码块中放原始 JSON。本工具专注数组表格，不会自动生成标题列表或长篇文档。
发现了这个转换器处理不好的边界情况？