.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]와 필드 헤더로 LLM의 필드 파싱 정확도를 높게 유지
  • @toon-format/toon을 통해 타입이 보존된 원래 JSON으로 무손실 왕복 변환

단점 및 주의사항

  • 신규 포맷이므로 기본 브라우저 JSON API로 바로 파싱할 수 없음
  • 항목마다 키 구조가 제각각인 비정형 트리에서는 토큰 절감 폭이 줄어듦
  • LLM 입출력 경계에서 인코딩·디코딩 변환 단계가 한 번 필요함

참고 자료

TOON 로컬 변환 및 정리 도구

관련 엔지니어링 가이드

TOON 자주 묻는 질문

TOON은 JSON 대비 LLM 토큰 수를 얼마나 줄여주나요?

DB 조회 행이나 API 목록 같은 균일 객체 배열에서는 헤더에 키를 한 번만 선언하므로 일반 JSON보다 보통 35%~60%의 토큰을 절약합니다.

TOON을 다시 JSON으로 변환해도 데이터 타입이 손실되지 않나요?

손실되지 않습니다. 문자열, 숫자, 불리언, null, 중첩 객체 및 배열 모두 원래 JSON 타입 그대로 정확하게 복원됩니다.

TOON 표 블록 내부에서 어떤 구분자를 쓰는 것이 가장 효율적인가요?

쉼표가 기본이며 가독성이 좋고, 값에 공백이나 쉼표가 많을 때는 탭(\t) 또는 파이프(|)를 사용하면 o200k_base 토큰을 수 % 더 아낄 수 있습니다.