.toon · text/plain

TOON: TOON(トークン指向オブジェクト記法)

TOON は、ネスト構造に YAML 風のインデントを用い、均一配列を宣言的ヘッダー(`items[N]{col1,col2}:`)と CSV 風行データで表すトークン節約フォーマットです。

クイックアンサー: TOON は、ネスト構造に YAML 風のインデントを用い、均一配列を宣言的ヘッダー(`items[N]{col1,col2}:`)と CSV 風行データで表すトークン節約フォーマットです。 均一な JSON オブジェクト配列を GPT-5、Claude 4、Gemini へ渡す際の LLM トークンコスト 30〜60% 削減。

構造タイプ階層構造
可読性高
ネスト対応対応
LLM トークン効率高
拡張子.toon
MIME タイプtext/plain
主な用途均一な JSON オブジェクト配列を GPT-5、Claude 4、Gemini へ渡す際の LLM トークンコスト 30〜60% 削減。

メリット

  • 構造化レコード配列における LLM 入力トークン消費量を 30%〜60% 削減
  • 要素数 [N] とフィールドヘッダーを明示するためモデルの解釈精度が高い
  • @toon-format/toon により型付き JSON へ損失なく完全復元できる

注意点・トレードオフ

  • 新しいフォーマットのため標準ブラウザの JSON API では直接パースできない
  • 各要素のキー構成がバラバラな不均一ツリーでは削減効果が小さくなる
  • LLM 入出力の境界で変換・逆変換のステップが必要になる

参考文献

TOON をローカルで変換・整形

関連エンジニアリングガイド

関連フォーマット

全24形式を見る

TOON に関するよくある質問

TOON は JSON と比べてどの程度 LLM トークンを削減できますか?

DB レコードや API 一覧のような均一オブジェクト配列では、キー名をヘッダーで1回だけ宣言することで通常 35%〜60% のトークンを削減できます。

TOON から JSON に戻したとき、数値や真偽値などの型は失われませんか?

失われません。文字列、数値、真偽値、null、ネストオブジェクト・配列がそのまま元の JSON 型として正確に復元されます。

TOON の表ブロックではどの区切り文字を使うのが効果的ですか?

標準のカンマが最も読みやすく、値にスペースやカンマが多い場合はタブ(\t)やパイプ(|)を選ぶと o200k_base でさらに数%削減できます。