JSON을 YAML 형식으로 변환하는 방법

JSON과 YAML 변환의 기본 이해

JSON을 YAML 형식으로 바꾸는 작업은 설정 자료를 다른 형식으로 정리하거나, 사람이 읽기 쉬운 구조로 확인해야 할 때 유용합니다. 이 도구는 입력한 JSON 텍스트를 바탕으로 객체, 중첩된 객체, 배열을 포함하는 내용을 YAML 텍스트로 변환합니다. 따라서 먼저 변환할 자료가 JSON 문법에 맞는지 살펴본 뒤 사용하면 결과를 확인하기 쉽습니다.

입력란에는 JSON 텍스트를 넣을 수 있으며, 입력을 생략하는 것도 가능합니다. 아무 내용도 넣지 않거나 공백만 입력한 경우에는 변환 자체가 성공으로 처리되지만, 만들어지는 YAML 텍스트는 비어 있습니다. 변환할 자료가 있다면 중괄호로 감싼 객체나 대괄호로 감싼 배열처럼 JSON의 구조를 유지한 텍스트를 준비하세요.

이 도구에는 결과의 들여쓰기 폭을 정하는 설정과 매핑 키 정렬을 선택하는 설정이 있습니다. 들여쓰기 값을 지정하지 않으면 기본값 2가 적용되고, 키 정렬은 기본적으로 꺼져 있습니다. 자료의 계층을 눈으로 비교해야 한다면 들여쓰기 설정을 살펴보고, 키를 정해진 순서로 보고 싶을 때만 정렬 옵션을 선택하는 방식이 적절합니다.

JSON 텍스트를 변환하는 실제 순서

변환할 JSON 텍스트를 준비합니다. 문자열은 JSON 규칙에 맞는 큰따옴표를 사용하고, 객체 안의 항목은 쉼표로 구분합니다. 중괄호와 대괄호가 서로 알맞게 닫히는지도 입력 전에 확인하세요.
준비한 내용을 입력 영역에 붙여 넣습니다. 단일 객체뿐 아니라 객체 안에 다른 객체가 들어 있는 구조와 배열이 포함된 구조도 입력할 수 있습니다. 여러 단계로 중첩된 자료라면 각 항목의 괄호와 쉼표 위치를 차례로 살펴보면 오탈자를 찾는 데 도움이 됩니다.
결과의 모양을 조정할 필요가 있을 때 들여쓰기 설정을 확인합니다. 별도의 숫자를 지정하지 않으면 들여쓰기는 2를 기준으로 처리됩니다. 같은 자료를 다시 변환하면서 읽기 편한 계층 표시를 비교하려는 경우에는 원하는 숫자 설정을 선택하세요.
매핑 키의 정렬이 필요하다면 해당 선택 항목을 활성화합니다. 이 설정을 사용하지 않으면 키 정렬을 요청하지 않은 기본 상태로 처리됩니다. 입력에 나타난 순서를 기준으로 결과를 살펴보고 싶다면 정렬 옵션을 켜지 않은 상태를 유지하세요.
변환을 실행한 뒤 성공 여부와 결과 영역을 확인합니다. 유효한 JSON이면 YAML 형식의 텍스트가 생성되며, 비어 있는 입력은 빈 결과로 성공 처리됩니다. 입력이 유효한 JSON이 아니면 변환이 성공하지 않고 YAML 텍스트도 생성되지 않으므로, 실패한 경우에는 JSON 문법을 다시 고친 뒤 재시도해야 합니다.

변환 결과를 확인하는 기준

성공한 결과는 한 줄로 이어진 표현이 아니라 블록 스타일의 YAML 텍스트로 나타납니다. 객체의 계층은 들여쓰기로 구분되므로, 상위 항목과 하위 항목의 간격을 따라가면 중첩 관계를 읽을 수 있습니다. 내용이 있는 배열은 목록 표시로 표현되기 때문에 배열 항목이 여러 개라면 각각의 시작 위치를 비교해 보세요.

문자열 안에 YAML 문법과 혼동될 수 있는 내용이 있으면 결과에서 해당 문자열에 따옴표가 붙을 수 있습니다. 이는 입력 문자열을 YAML 문맥에서 구분해 표시하는 결과 형태이며, JSON을 입력했을 때의 공백이나 줄바꿈 같은 원본 서식이 그대로 복사된다는 뜻은 아닙니다. 또한 한글과 같은 유니코드 문자는 결과에서 보존됩니다.

키 정렬을 선택한 경우에는 매핑 키가 정렬된 결과인지 확인하고, 선택하지 않은 경우에는 정렬을 요청하지 않은 설정으로 결과를 읽으세요. 결과 영역에 YAML 텍스트가 나타나지 않으면 빈 입력인지, JSON 문법이 잘못되었는지부터 구분하는 것이 좋습니다. JSON 텍스트가 유효하지 않아 발생한 실패와 YAML 직렬화 과정의 실패는 모두 성공 결과로 간주하지 않으므로, 생성된 텍스트가 있을 때만 다음 작업에 사용하세요.

이 도구의 역할은 JSON 텍스트를 YAML 텍스트로 바꾸는 데 있습니다. 원본의 모든 공백과 서식을 보존하거나 원래 JSON과 완전히 같은 방식으로 되돌릴 수 있다고 전제하지 말고, 변환된 구조와 필요한 문자열 표현을 별도로 검토하세요.

사용 예시

설정 자료를 문서에 넣기 전에 이름과 태그 배열이 포함된 JSON을 YAML 형태로 바꾸려는 상황입니다.

입력 영역에 {"name":"상품 설정","tags":["신규","한국어"]}를 넣고 기본 설정으로 변환을 실행합니다.

성공한 결과에는 name 항목과 tags 배열이 포함됩니다. tags 아래의 내용은 YAML 목록 표시로 나타나고, 입력한 한글 문자열은 결과에서 보존됩니다.

제한 사항

결과는 블록 스타일 YAML로 만들어지며 문법상 필요한 문자열에 따옴표가 붙을 수 있으므로 원본 JSON의 공백과 서식이 그대로 보존된다고 볼 수 없습니다.

자주 발생하는 오류

쉼표가 빠졌거나 문자열을 큰따옴표로 감싸지 않은 JSON을 입력하면 변환이 성공하지 않아 결과 텍스트가 나오지 않습니다. 항목 사이의 쉼표, 문자열의 따옴표, 중괄호와 대괄호의 짝을 확인한 뒤 유효한 JSON으로 다시 입력하세요.

자주 묻는 질문

JSON을 입력하지 않고도 변환할 수 있나요?

입력 없이 실행하는 것은 가능합니다. 입력이 비어 있거나 공백뿐이면 성공 처리는 되지만, 결과 영역의 YAML 텍스트도 비어 있는 상태가 됩니다.

배열을 포함한 JSON도 YAML로 바꿀 수 있나요?

배열이 들어 있는 유효한 JSON도 변환 대상에 포함됩니다. 내용이 있는 배열은 결과에서 목록 표시를 사용하므로 항목별 구조를 확인할 수 있습니다.

키 순서와 들여쓰기 폭을 조정할 수 있나요?

키 정렬은 선택 항목으로 제공되며 기본 상태에서는 꺼져 있습니다. 들여쓰기 숫자를 따로 지정하지 않을 때에는 기본값 2가 적용됩니다.