.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 vs JSON: LLM 프롬프트 토큰 비용 30–60% 절감하기TOON 표기법이 균일한 배열에서 반복되는 JSON 키를 제거해 GPT-5, Claude 4, Gemini 2.5 프롬프트 비용을 크게 줄이는 원리를 알아봅니다.
- CSV와 JSON으로 유효한 JSONL 파인튜닝 데이터셋 구축하기스프레드시트와 JSON 배열에서 OpenAI 채팅, Alpaca 및 Gemini 파인튜닝에 바로 쓸 수 있는 유효한 .jsonl 파일을 줄 단위 검증과 함께 로컬 생성합니다.
- PDF, Word, Excel 문서를 RAG 및 LLM용 깔끔한 마크다운으로 변환하기보안이 중요한 PDF, Word DOCX 문서, Excel 시트를 업로드 없이 구조화된 마크다운으로 추출해 벡터 청킹과 LLM 컨텍스트에 최적화합니다.
- JSON에서 TypeScript, Zod 및 Pydantic v2 스키마 생성으로 타입 안전성 확보API JSON 샘플을 선택적 필드(?) 및 별칭 추론이 포함된 엄격한 TypeScript 인터페이스, Zod 런타임 검증기, Python Pydantic v2 모델로 변환합니다.
관련 형식
24개 형식 전체 보기TOON 자주 묻는 질문
TOON은 JSON 대비 LLM 토큰 수를 얼마나 줄여주나요?
DB 조회 행이나 API 목록 같은 균일 객체 배열에서는 헤더에 키를 한 번만 선언하므로 일반 JSON보다 보통 35%~60%의 토큰을 절약합니다.
TOON을 다시 JSON으로 변환해도 데이터 타입이 손실되지 않나요?
손실되지 않습니다. 문자열, 숫자, 불리언, null, 중첩 객체 및 배열 모두 원래 JSON 타입 그대로 정확하게 복원됩니다.
TOON 표 블록 내부에서 어떤 구분자를 쓰는 것이 가장 효율적인가요?
쉼표가 기본이며 가독성이 좋고, 값에 공백이나 쉼표가 많을 때는 탭(\t) 또는 파이프(|)를 사용하면 o200k_base 토큰을 수 % 더 아낄 수 있습니다.