본문으로 건너뛰기
yutils
예시

입력 (TOML)

name = "yutils"
version = "0.1.0"

[tools]
count = 55
launched = true

[[contributors]]
name = "jade"

출력 (JSON)

{
  "name": "yutils",
  "version": "0.1.0",
  "tools": {
    "count": 55,
    "launched": true
  },
  "contributors": [
    { "name": "jade" }
  ]
}

참고

Rust `Cargo.toml` · Python `pyproject.toml` 등 실 환경 TOML 호환. 양방향 변환 지원.

사용법 / 자주 묻는 질문

이런 경우 사용하세요

  • Cargo.toml · pyproject.toml · uv.toml 등 Rust/Python 설정 JSON 화
  • JSON 설정을 TOML 로 변환해 가독성 향상 (Rust · Hugo · Zola 환경)
  • Static site generator(Hugo · Zola) 의 front matter 변환
  • Wrangler · Cloudflare 설정의 형식 변환
  • TOML 문법 학습 — JSON 과 양쪽 보면서 매핑 파악

자주 묻는 질문

Q.어떤 TOML 스펙을 따르나요?
A.TOML 1.0.0 표준을 기반으로 합니다. 날짜·시간 타입(`2026-05-13T00:00:00Z`)도 JSON 문자열로 정확히 보존.
Q.TOML 의 array of tables(`[[...]]`) 는 어떻게?
A.JSON 배열로 변환됩니다 (예: `[[contributors]]` 두 번 → `{"contributors": [...]}` 길이 2 배열).
Q.주석은 보존되나요?
A.JSON 에는 주석 개념이 없어 변환 시 제거됩니다. 다시 TOML 로 돌려도 원본 주석은 복원되지 않습니다.
재미있는 사실
  • TOML 은 2013년 Tom Preston-Werner (GitHub 공동창업자, Gravatar 만든 사람) 가 만든 설정 파일 형식입니다. 슬로건은 '명확하고 최소한 (obvious, minimal)' — YAML 의 미묘한 함정 (인덴트·부동소수점 trap) 과 INI 의 부족한 구조 사이의 sweet spot.

    TOML — Official site
  • Rust 의 `Cargo.toml`, Python 의 `pyproject.toml` (PEP 518 / 621) 같은 모던 도구가 TOML 채택. JSON 과 달리 주석 지원, YAML 과 달리 인덴트 의존 X — '사람이 쓰고 컴퓨터가 읽기' 의 균형.

    TOML — GitHub
  • TOML 1.0.0 정식 표준은 2021년 1월. 만들어진 후 8년 만의 stable — 그 사이 0.x 버전이 여러 차례 바뀌면서 '미세 호환성' 문제가 있었기 때문에 1.0 의 의미가 컸습니다.

    TOML 1.0.0 (2021)