JSON 与 TOON 互转

工具简介：什么是 TOON？

TOON（Token-Oriented Object Notation） 是一种面向 Token 的数据表示法，完全兼容 JSON 的对象、数组、字符串、数字、布尔与 null，但通过缩进和表头的方式减少了重复的括号与键名。数组会声明长度（如 [3]）以及字段集合（如 {id,email}），因此在 Markdown、知识库或 LLM 上下文中更加紧凑、可读。

常见应用场景

• 将 API 响应压缩后用于 LLM 提示词
• 把结构化数据整理进文档或知识库
• 在 JSON 与 TOON 之间来回转换校验

为什么需要 TOON？

1. 大幅节省 Token：在结构化列表中比常规 JSON 少 30%~60% 的 Token，本地测试和官方 benchmark 均已验证。
2. 更易给 LLM 理解：显式的 [N] 与字段名让模型立即知道需要输出多少行、哪些列。
3. 便于人工审核与分享：可读性接近 YAML+CSV，适合放进文档、Notion、GitHub README。
4. 零成本迁移：TOON 只是 JSON 的另一种表示，随时可以转回 JSON，用于接口、数据库、脚本等场景。

相比 JSON 的区别

特性	JSON	TOON
结构表现	使用大量 {}、[] 和重复键名	用缩进与表头描述结构，减少冗余
Token 成本	对于大表格较高	对齐字段后只保留值，显著降低
可验证性	需额外 Schema	[N]、字段集合和统一分隔符自带校验
LLM 友好度	需要额外提示	结构本身就是提示，模型更少犯错

当数组元素结构不一致或出现深层嵌套时，TOON 会自动退回普通列表表示，不会丢失任何信息。因此它既保持 JSON 的严谨性，又让多数业务数据更精简。

如何使用本工具

1. 在输入区选择当前内容是 JSON 还是 TOON，并粘贴数据。
2. 如果要导出 TOON，可选择逗号、制表符或竖线作为表格分隔符；如果要回到 JSON，可选择希望的缩进。
3. 点击 JSON → TOON 或 TOON → JSON。工具使用官方 @toon-format/toon 编解码库，保证格式100%一致。
4. 复制结果即可放入 LLM 提示词、知识库、博客教程或团队文档。

通过这种方式，你能把 API 响应、日志、配置等结构化信息一键瘦身，在不损失语义的情况下节省上下文成本，同时向团队科普最新的 TOON 格式。

❓ 常见问题 FAQ

Q1：转换后结构不一致？
A：当数组元素结构不同会退回普通列表，这是正常行为。

Q2：如何选择表格分隔符？
A：根据场景选择逗号、制表符或竖线以便阅读。

Q3：能否完全还原 JSON？
A：TOON 与 JSON 可互转，确保输入格式正确即可还原。