TOML-JSON 변환기
TOML과 JSON 설정 파일 형식을 서로 변환하세요.
활용 예시
Rust·Python 프로젝트 설정 읽기
Cargo.toml, pyproject.toml 같은 설정 파일은 중첩된 값을 확인하거나 다른 도구에 넣을 때 JSON으로 보면 더 쉽게 훑어볼 수 있습니다.
설정 파일을 TOML로 옮기기
새 도구가 TOML을 요구하는데 설정이 JSON으로 되어 있나요? JSON을 붙여넣으면 테이블과 배열이 올바르게 정리된 TOML 파일을 얻을 수 있습니다.
GitHub Actions나 CLI 도구의 TOML 설정 살펴보기
TOML 설정을 먼저 JSON으로 변환하면 다른 환경의 설정과 빠르게 비교하거나 JSON 기반 스크립트에 붙여넣기 쉬워집니다.
GitHub Actions나 Cargo 설정을 손으로 작성하기
더 편하다면 먼저 JSON으로 구조를 작성한 뒤, Cargo.toml처럼 TOML을 요구하는 파일에 맞춰 변환할 수 있습니다.
TOML 테이블 배열이 JSON에서 어떻게 보이는지 확인하기
"[[section]]" 형태의 테이블 배열 문법을 쓰는 TOML 파일을 JSON으로 변환해보면, 이것이 평범한 JSON 객체 배열이 된다는 것을 명확히 확인할 수 있습니다.
빠른 참고표
TOML → JSON
| TOML | JSON |
|---|---|
| title = "TOML" | {"title":"TOML"} |
| lit = 'C:\path' | {"lit":"C:\\path"} |
| port = 8080 | {"port":8080} |
| big = 1_000_000 | {"big":1000000} |
| hex = 0xff | {"hex":255} |
| oct = 0o755 | {"oct":493} |
| bin = 0b1101 | {"bin":13} |
| pi = 3.14 | {"pi":3.14} |
| exp = 5e+22 | {"exp":5e+22} |
| enabled = true | {"enabled":true} |
| date = 1979-05-27 | {"date":"1979-05-27"} |
| dt = 1979-05-27T07:32:00Z | {"dt":"1979-05-27T07:32:00.000Z"} |
| time = 07:32:00 | {"time":"07:32:00.000"} |
| arr = [1, 2, 3] | {"arr":[1,2,3]} |
| mixed = [1, "a"] | {"mixed":[1,"a"]} |
| inline = { x = 1, y = 2 } | {"inline":{"x":1,"y":2}} |
| a.b.c = 1 | {"a":{"b":{"c":1}}} |
| "quoted key" = 1 | {"quoted key":1} |
| [server]\nhost = "localhost" | {"server":{"host":"localhost"}} |
| [[items]]\nid = 1\n[[items]]\nid = 2 | {"items":[{"id":1},{"id":2}]} |
| s = """\nline1\nline2""" | {"s":"line1\nline2"} |
JSON → TOML
| JSON | TOML |
|---|---|
| {"a": "text"} | a = "text" |
| {"a": 1.5} | a = 1.5 |
| {"a": "2024-01-15"} | a = "2024-01-15" |
| {"a b": 1} | "a b" = 1 |
| {"a": [1, "x"]} | a = [ 1, "x" ] |
| {"a": []} | a = [] |
| {"a": {"b": 1}} | [a]\nb = 1 |
| {"a": {}} | [a] |
| {"items": [{"id": 1}, {"id": 2}]} | [[items]]\nid = 1\n\n[[items]]\nid = 2 |
| {"a": null, "b": 1} | b = 1 (참고: TOML에는 null 값이 없어서, null 값을 가진 키는 결과에서 생략되었습니다.) |
| [1, 2] | 변환 오류: stringify can only be called with an object |
자주 묻는 질문
데이터가 서버로 전송되나요?
아니요. 변환은 smol-toml 라이브러리를 사용해 브라우저 안에서만 이루어집니다. 붙여넣은 내용은 어디로도 업로드되지 않습니다.
JSON을 TOML로 바꿀 때 'null' 값은 어떻게 되나요?
TOML에는 null을 표현하는 고유한 방법이 없습니다. 값이 null인 키는 오류 없이 결과 TOML에서 조용히 제거됩니다. 이 정보를 유지해야 한다면 변환 전에 null 대신 빈 문자열이나 불리언 플래그 같은 대체 값을 사용하는 것을 고려하세요.
모든 JSON 구조를 TOML로 변환할 수 있나요?
중첩 객체(TOML 테이블로)와 배열을 포함해 대부분 변환할 수 있습니다. 다만 TOML은 같은 배열 안에 여러 타입을 섞거나 최상위 값이 객체가 아닌 경우에는 JSON보다 유연하지 않아서, 특이한 구조는 변환이 실패할 수 있습니다—오류 메시지에 원인이 표시됩니다.
변환할 때 키 순서가 유지되나요?
네, 양방향 모두 원본 문서에 나타난 키 순서를 그대로 유지합니다.
TOML의 날짜·시간 타입도 지원하나요?
네. JSON에는 날짜 전용 타입이 없으므로, TOML의 날짜·시간·날짜시간 값은 JSON에서 ISO 8601 문자열 형태로 변환됩니다.
TOML의 일반 테이블과 인라인 테이블은 어떻게 다른가요?
일반 테이블('[section]')은 이후에 오는 키들이 속하는 새로운 블록을 시작하는 방식이고, 인라인 테이블('{ key = value }')은 한 줄로 표현하는 간결한 객체입니다. 둘 다 변환하면 같은 형태의 중첩 JSON 객체가 됩니다.
TOML 파일의 일부분만 떼어내서 변환할 수 있나요?
입력은 그 자체로 완결된 유효한 TOML 문서여야 합니다. 테이블 헤더 없이 키 목록만 있는 것처럼 파일의 나머지 맥락에 의존하는 조각을 떼어내 붙여넣으면 파싱에 실패할 수 있습니다.