TOML에서 JSON으로 변환기

TOML에서 JSON으로 변환기에 오신 것을 환영합니다. 이 도구는 단 한 번의 클릭으로 모든 TOML 설정을 깨끗하고 유효한 JSON으로 변환해주는 무료 온라인 도구입니다. Cargo.toml을 JSON 기반 파이프라인으로 마이그레이션하거나, 깊게 중첩된 설정을 시각적으로 디버깅하거나, JSON만 허용하는 서비스에 TOML 파일을 입력하려는 경우, 이 변환기는 테이블, 서브 테이블, 테이블 배열, 인라인 테이블, 점 표기법 키, 다중행 문자열, 16진수/8진수/2진수 정수, 날짜 및 특수한 부동 소수점 등 모든 TOML 구조를 정확하게 처리합니다. 워크플로우에 맞는 출력 스타일(Pretty 2-space, Pretty 4-space, Compact, 키 정렬)을 선택하고 구조 트리, 통계 대시보드 및 변환 다이어그램을 통해 결과를 확인하세요.

TOML이란 무엇이며 왜 JSON으로 변환해야 하나요?

TOML (Tom's Obvious Minimal Language)은 명확하고 사람이 읽기 쉽도록 설계된 설정 형식입니다. Cargo (Rust), Poetry (Python) 및 기타 여러 개발자 도구의 패키지 메타데이터를 관리하는 데 사용됩니다. 반면 JSON은 웹에서 보편적으로 사용되는 데이터 교환 형식입니다. REST API, 문서 데이터베이스, 브라우저의 localStorage, JavaScript 앱 등 많은 시스템이 JSON만 지원합니다. TOML을 JSON으로 변환하면 설정을 다시 작성하지 않고도 이 두 세계를 연결할 수 있습니다.

TOML을 JSON으로 변환하는 일반적인 이유

• JSON 전용 API에 TOML 데이터 입력 — 예를 들어 배포 서비스나 기능 플래그(feature-flag) 플랫폼 등이 있습니다.
• 중첩된 설정을 시각적으로 검토 — JSON의 대괄호와 중괄호 구조는 계층 구조를 한눈에 파악하기 쉽게 해줍니다.
• 프론트엔드 설정 번들 생성 — 작성 형식은 TOML로 유지하고, 브라우저에는 JSON을 전송합니다.
• 린터 및 JSON Schema 활용 — TOML 구조를 JSON Schema 검증기에 통과시켜 유효성을 검사합니다.
• 설정 비교 — 환경 간에 키가 정렬된 JSON을 diff하여 변경 사항을 감지합니다.
• 기존 설정 마이그레이션 — TOML 파일을 점진적으로 JSON 기반 설정 서비스로 이식합니다.

이 변환기의 주요 기능

• TOML 1.0 완벽 지원 — 기본 및 리터럴 문자열(단일 및 다중행), 밑줄 구분자가 있는 10진수/16진수/8진수/2진수 정수, 과학적 표기법 부동 소수점, inf, -inf, nan, 불리언, 날짜 및 날짜/시간 지원.
• 중첩 구조 처리 — 테이블, 서브 테이블([a.b.c]), 테이블 배열([[a]]), 인라인 테이블({ a = 1, b = 2 }) 및 점 표기법 키 지원.
• 네 가지 출력 스타일 — Pretty 2-space, Pretty 4-space, Compact (압축형), 그리고 diff 비교에 유리한 Sorted Keys 지원.
• 시각적 구조 트리 — TOML 구조가 JSON 객체와 배열로 어떻게 변환되는지 유형 배지(table, AoT, array, string, number, bool)와 함께 확인.
• 통계 대시보드 — 테이블, 키, 배열, 테이블 배열의 개수, 깊이, 입력/출력 글자 수 확인.
• 라인 단위 에러 메시지 — 모든 파싱 에러에 정확한 라인 번호가 포함되어 즉시 수정 가능.
• 클릭 한 번 샘플 라이브러리 — Cargo.toml 스타일, pyproject 스타일, 애플리케이션 설정, 숫자 또는 다중행 문자열 예제 로드.
• 복사 및 다운로드 — JSON을 클립보드에 복사하거나 .json 파일로 다운로드.
• 모바일 반응형 — 스마트폰, 태블릿, 데스크톱에서 편리하게 작동.
• 데이터 보안 — 모든 파싱은 서버 측에서 이루어지며 결과는 즉시 반환됩니다. 어떤 데이터도 저장되지 않습니다.

TOML에서 JSON으로의 매핑 방식

대부분의 TOML 구조는 손실 없이 JSON으로 변환됩니다. 적용되는 매핑 규칙은 다음과 같습니다.

예제

title = "App"
[server]
host = "localhost"
port = 8080

{
  "title": "App",
  "server": {
    "host": "localhost",
    "port": 8080
  }
}

[[user]]
name = "Alice"
admin = true


[[user]]
name = "Bob"
admin = false

{
  "user": [
    { "name": "Alice", "admin": true },
    { "name": "Bob",   "admin": false }
  ]
}

db.host = "10.0.0.1"
db.port = 5432
db.options = { ssl = true, pool = 20 }

{
  "db": {
    "host": "10.0.0.1",
    "port": 5432,
    "options": { "ssl": true, "pool": 20 }
  }
}

TOML에서 JSON으로 변환기 사용 방법

1. 입력창에 TOML을 붙여넣거나, 퀵 샘플 칩을 클릭하여 일반적인 설정을 불러옵니다.
2. 출력 스타일을 선택합니다 — Pretty 2-space(기본), Pretty 4-space, Compact, 또는 Sorted Keys.
3. JSON으로 변환을 클릭합니다. 도구가 TOML을 파싱하여 통계 및 구조 트리와 함께 JSON 출력을 생성합니다.
4. 결과를 확인합니다 — 통계 대시보드에서 요약을 보고, 구조 트리를 확장하여 계층을 확인하며, 변환 다이어그램을 통해 매핑 구조를 이해합니다.
5. JSON을 복사하거나 다운로드합니다. 복사 버튼은 클립보드에 저장하고, 다운로드 버튼은 converted.json 파일로 저장합니다.

지원되는 TOML 기능

문자열

• 기본 문자열은 큰따옴표를 사용하며 \n, \t, \r, \", \\, \uXXXX, \UXXXXXXXX와 같은 이스케이프 시퀀스를 지원합니다.
• 리터럴 문자열은 작은따옴표를 사용하며 이스케이프 없이 문자 그대로 포함합니다.
• 다중행 기본 문자열은 삼중 큰따옴표(""")를 사용하며 백슬래시를 통한 공백 제거를 지원합니다.
• 다중행 리터럴 문자열은 삼중 작은따옴표(''')를 사용하며 모든 내용을 그대로 보존합니다.

숫자

• 10진수 정수: 밑줄 구분자를 포함할 수 있습니다(예: 1_000_000).
• 16진수/8진수/2진수 정수: 0xDEADBEEF, 0o755, 0b1010.
• 부동 소수점: 부호, 소수점, 지수를 포함할 수 있습니다(예: 3.14, -2e-3, 6.022e23).
• 특수 부동 소수점: inf, -inf, nan (JSON null로 변환됨).

테이블 및 배열

• 테이블: [name]으로 새로운 테이블을 시작합니다.
• 서브 테이블: [a.b.c]로 중첩된 테이블을 생성합니다.
• 테이블 배열: [[name]]으로 배열에 새 테이블을 추가합니다.
• 인라인 테이블: { a = 1, b = 2 }.
• 배열: [1, 2, 3]은 여러 줄에 걸쳐 작성될 수 있으며 혼합된 값 유형을 가질 수 있습니다.

올바른 출력 스타일 선택하기

• Pretty 2-space — 기본값입니다. 간결하면서도 가독성이 좋아 Git에 커밋되는 설정 파일에 이상적입니다.
• Pretty 4-space — PEP-8 스타일의 들여쓰기와 일치하며, 일부 Python 및 Java 팀에서 선호합니다.
• Compact (압축형) — 공백이 없는 단일행으로, 네트워크 전송 시 가장 적은 용량을 차지합니다.
• Sorted Keys — 키를 알파벳순으로 정렬한 Pretty 출력입니다. 키 순서에 상관없이 항상 동일한 바이트 결과를 생성하므로 diff 비교에 탁월합니다.

자주 묻는 질문

TOML이란 무엇이며 왜 JSON으로 변환해야 하나요?

TOML은 명확하고 최소화된 설계를 목표로 하는 설정 형식입니다. JSON으로 변환하면 JSON만 지원하는 시스템에 입력하거나, 중첩 구조를 시각적으로 확인하고, 웹 API와 공유하며, JSON을 기대하는 JavaScript 코드와 통합할 수 있습니다.

이 변환기는 테이블 배열과 인라인 테이블을 지원하나요?

네. [[array.of.tables]] 구문(JSON 객체 배열로 변환), { a = 1, b = 2 }와 같은 인라인 테이블(JSON 객체로 변환), 중첩된 서브 테이블, 점 표기법 키 및 임의의 중첩 깊이를 완벽하게 지원합니다.

어떤 출력 스타일을 지원하나요?

네 가지 스타일을 지원합니다: Pretty 2-space (기본), Pretty 4-space (PEP-8 스타일), Compact (압축형 단일행), Sorted Keys (알파벳순 정렬).

TOML 날짜 및 시간은 JSON으로 어떻게 변환되나요?

JSON에는 기본 날짜 유형이 없으므로 TOML의 날짜/시간(2026-04-25T12:00:00Z와 같은 RFC 3339 형식)은 JSON 출력에서 문자열로 유지됩니다.

TOML의 inf 및 nan 값은 어떻게 처리되나요?

표준 JSON은 Infinity 또는 NaN 리터럴을 허용하지 않으므로 TOML의 inf, -inf, nan은 JSON 출력에서 null로 변환됩니다. 이는 RFC 8259를 엄격히 준수합니다.

파싱 에러는 어디서 발생하며 어떻게 수정하나요?

에러가 발생한 정확한 라인 번호와 문제 설명(종료되지 않은 문자열, 중복 키 등)을 제공합니다. 주로 따옴표/괄호 불일치나 테이블 재정의 실수 등이 원인입니다.

크기 제한이 있나요?

수 메가바이트 크기의 TOML 파일도 원활하게 처리할 수 있습니다. 매우 큰 파일의 경우 파싱보다는 브라우저의 렌더링 성능이 더 큰 영향을 줄 수 있습니다.

내 TOML 데이터가 어디로 전송되거나 저장되나요?

입력값은 서버 측에서 파싱되어 결과를 생성한 후 즉시 삭제됩니다. 저희는 사용자의 설정을 기록, 저장하거나 외부로 전송하지 않습니다.

JSON을 다시 TOML로 변환할 수 있나요?

이 도구는 단방향(TOML → JSON)입니다. 역방향 변환을 위해서는 JSON-to-TOML 변환기나 Python의 tomli_w, JavaScript의 @iarna/toml과 같은 라이브러리를 사용하세요.

깨끗한 변환을 위한 팁

• Diff 비교 시 Sorted-key 출력을 사용하세요 — 팀원 간에 버전 관리되는 JSON이 일관되게 유지됩니다.
• 긴 텍스트에는 다중행 문자열 (""" 또는 ''')을 사용하세요 — \n으로 연결하는 것보다 훨씬 읽기 좋습니다.
• 관련 키는 테이블로 그룹화하세요 — 긴 점 표기법 키보다 가독성이 높습니다.
• 테이블 재정의를 주의하세요 — TOML은 같은 테이블을 두 번 정의하는 것을 허용하지 않습니다. 변환기가 이를 에러로 잡아냅니다.
• 날짜와 시간은 RFC 3339 형식을 유지하세요 — 다른 형식도 파싱되지만, RFC 3339가 JSON 소비자들 사이에서 가장 깔끔하게 호환됩니다.

추가 리소스

• 공식 TOML 사양
• 위키백과 TOML 설명
• JSON.org — JSON 소개
• RFC 8259 — JavaScript Object Notation (JSON) 데이터 교환 형식