TOML 설정 데이터를 JSON 형식으로 변환하는 방법

개요 | TOML 설정을 JSON으로 변환하는 용도

TOML 설정 파일을 JSON 형식으로 바꿔야 할 때 이 변환기를 사용할 수 있습니다. TOML 텍스트를 입력하면 문자열, 숫자, 불리언 값과 중첩된 테이블 구조를 JSON 데이터로 변환합니다. JSON 들여쓰기 수준과 키 정렬 여부도 지정할 수 있어 설정 데이터를 확인하거나 다른 도구로 옮길 때 활용하기 좋습니다.

사용 방법

TOML 설정 내용을 입력 영역에 붙여 넣습니다. 입력은 선택 사항이며, 아무 내용도 넣지 않으면 기본값인 빈 문자열로 처리됩니다.
JSON 출력의 들여쓰기 숫자를 지정합니다. 별도로 바꾸지 않으면 기본 들여쓰기는 2입니다.
필요할 때 키 정렬 옵션을 켭니다. 기본값은 키 정렬을 사용하지 않는 상태입니다.
변환을 실행하고 결과를 확인합니다. 입력한 TOML에 문자열, 숫자, 불리언 또는 중첩된 테이블이 있으면 대응하는 JSON 구조로 표시됩니다.
날짜, 시간, 날짜와 시간이 포함된 값은 결과에서 ISO 형식 문자열로 확인합니다. TOML 문법이 올바르지 않으면 변환에 실패하므로 입력 내용을 수정한 뒤 다시 실행합니다.

결과 해석과 주의점

성공한 결과는 입력한 TOML의 값과 중첩 구조를 JSON 표현으로 보여 줍니다. 들여쓰기 설정은 읽기 쉬운 모양에 영향을 주고, 키 정렬 옵션은 결과의 키 배열 순서에 영향을 줍니다. 공백만 있는 입력도 성공하며 빈 JSON 객체 표현을 생성합니다.

변환 실패는 TOML 문법 오류에서 발생할 수 있습니다. 또한 JSON 직렬화 단계에서 문제가 생기면 성공한 JSON 결과 대신 실패로 반환됩니다. 따라서 결과가 나타나지 않을 때는 먼저 TOML 문법과 값의 형태를 확인하고, 필요한 경우 들여쓰기나 키 정렬 설정을 조정해 다시 실행하세요.

사용 예시

서비스 설정의 제목과 담당자 정보를 담은 TOML을 JSON 구조로 확인하려고 합니다.

입력 영역에 title = "서비스 설정"과 [owner] name = "민수"가 포함된 TOML을 넣고 변환을 실행합니다.

성공하면 최상위 JSON 객체 안에 title 값과 owner라는 중첩 객체가 포함된 형태로 결과가 표시됩니다.

제한 사항

문법이 잘못된 TOML은 변환에 실패할 수 있으며, JSON 직렬화 단계의 문제도 실패 결과로 반환됩니다.

자주 발생하는 오류

TOML의 문법이 잘못된 상태로 실행하면 변환에 실패할 수 있습니다. 따옴표, 등호, 테이블 표기와 중첩 구조를 점검한 뒤 올바른 TOML을 다시 입력하세요.

자주 묻는 질문

TOML 입력을 비워 두면 어떻게 되나요?

빈 문자열이나 공백만 입력한 경우에는 변환이 성공하고 빈 JSON 객체 표현이 생성됩니다. 다른 TOML 내용은 해당 문법에 따라 처리됩니다.

JSON 키를 정렬할 수 있나요?

키 정렬 옵션을 켜면 JSON 표현의 키 정렬을 요청할 수 있습니다. 기본값은 정렬하지 않는 상태입니다.

TOML 날짜와 시간 값은 어떤 형태로 나오나요?

TOML의 날짜, 시간, 날짜와 시간 값은 결과에서 ISO 형식 문자열로 직렬화됩니다.