YAML을 JSON으로 변환하는 방법

변환을 시작하기 전에 확인할 점

YAML을 JSON 형식으로 바꾸려면 원문을 입력하고 변환 결과를 확인하면 됩니다. 이 도구는 YAML 텍스트를 읽어 JSON 텍스트로 다시 표현합니다. 단순한 키와 값뿐 아니라 매핑, 중첩된 매핑, 시퀀스도 다룰 수 있어 설정 자료나 구조화된 데이터를 다른 JSON 입력란에 옮길 때 활용하기 좋습니다.

변환 전에는 원문이 YAML 문법에 맞는지 살펴보세요. YAML의 주석, 따옴표를 적은 방식, 화면상의 배치가 JSON에 그대로 복사되는 것은 아닙니다. 여기서 확인할 대상은 표현 방식이 아니라 해석된 데이터 구조입니다. 결과를 사람이 읽기 쉽게 보이게 할지, 객체 키를 일정한 순서로 보이게 할지에 따라 선택 항목을 조정할 수 있습니다.

입력부터 결과 확인까지의 순서

변환할 YAML을 준비합니다. 키와 값의 관계를 확인하고, 하위 항목이 있다면 들여쓰기 수준을 맞춥니다. 목록은 시퀀스 형식으로 작성했는지 살펴봅니다. 입력란에 YAML 텍스트를 붙여 넣거나 직접 입력합니다.
입력 내용이 비어 있지 않은지 확인합니다. 공백만 있는 상태도 빈 입력으로 처리됩니다. 실제 데이터를 변환하려는 경우에는 붙여 넣은 내용이 입력 영역에 표시되는지 먼저 살펴보세요.
JSON 들여쓰기 설정을 고릅니다. 기본 설정은 2입니다. 여러 단계의 구조를 눈으로 검토하려면 들여쓰기를 적용한 결과가 편리합니다. 표시 공간을 줄이는 목적이라면 제공되는 설정에서 다른 값을 선택할 수 있습니다.
객체 키 정렬 여부를 정합니다. 키 정렬은 기본적으로 꺼져 있습니다. 결과를 비교할 때 키 순서를 일정하게 맞추고 싶다면 해당 선택 항목을 켭니다. 입력에서 해석된 순서를 기준으로 결과를 보고 싶다면 끈 상태로 둡니다.
변환을 실행합니다. 성공하면 입력한 YAML의 해석 결과가 JSON 텍스트로 표시됩니다. 매핑은 JSON 객체에 해당하고, 중첩 매핑은 내부 객체 구조로 나타나며, 시퀀스는 JSON 배열에 해당하는 형태로 직렬화됩니다.
문서가 여러 개인 YAML인지도 확인합니다. 입력을 왼쪽에서 다듬었을 때 ---로 시작하고 줄바꿈 뒤에 다시 ---가 있으면 여러 문서로 읽힐 수 있습니다. 파싱된 null 문서는 결과에서 제외됩니다. null이 아닌 문서가 둘 이상 남으면 JSON 배열이 되고, 하나만 남으면 그 문서가 반환됩니다. 남은 문서가 없으면 빈 JSON 객체가 생성됩니다.
결과를 다음 단계에 사용하기 전에 구조를 대조합니다. 객체의 키, 중첩 단계, 목록의 항목이 의도한 데이터와 맞는지 확인하고, 들여쓰기는 가독성 설정으로 이해합니다. 키 정렬을 켰다면 표시 순서가 달라질 수 있으므로 값과 구조를 중심으로 비교합니다.

완료된 변환을 판별하는 기준

성공 결과는 YAML 문장을 그대로 복사한 문서가 아니라, 파싱된 값을 JSON 문법의 텍스트로 직렬화한 결과입니다. 따라서 주석이나 원래의 따옴표 표기, 작성 당시의 화면 배치는 결과의 보존 대상이라고 볼 수 없습니다. 필요한 것은 데이터의 키와 값, 중첩 관계, 배열 항목이 올바르게 옮겨졌는지 확인하는 일입니다.

빈 입력이 성공하는 경우도 있습니다. 입력이 비어 있거나 공백만 있으면 변환 실패가 아니라 빈 JSON 객체가 결과로 나옵니다. 이 결과가 예상과 다르면 실행 전에 실제 YAML이 입력되었는지 확인해야 합니다.

여러 문서의 결과는 문서 수와 null 문서의 포함 여부에 따라 달라집니다. 문서가 여러 개 입력되었다고 해서 결과가 반드시 배열이 되는 것은 아닙니다. null 문서를 제외한 뒤 둘 이상의 문서가 남을 때만 배열이 되며, 한 문서만 남으면 해당 문서가 반환됩니다.

형식이 잘못된 YAML은 성공한 JSON 결과를 만들지 못합니다. 변환이 실패하면 들여쓰기, 콜론, 목록 표시, 문서 구분 기호를 입력 내용과 함께 다시 점검하세요. 파싱은 되었더라도 JSON으로 직렬화할 수 없는 값이 포함되면 성공 결과가 나오지 않을 수 있습니다. 그러므로 성공 여부와 결과 구조를 따로 확인하는 편이 안전합니다.

사용 예시

중첩된 설정과 여러 역할 항목을 포함한 YAML을 다른 JSON 입력란에서 사용할 형태로 바꾸려는 상황입니다.

애플리케이션 설정을 옮기기 위해 name: Mina와 roles: 아래의 목록을 포함한 YAML 텍스트를 입력한 뒤 변환을 실행합니다.

성공하면 입력한 객체와 목록의 관계가 JSON 텍스트 구조로 표시되고, 별도 변경이 없을 때 기본 들여쓰기 설정은 2로 적용됩니다.

제한 사항

문법이 잘못된 YAML이나 JSON으로 직렬화할 수 없는 파싱 결과는 성공한 JSON 결과로 변환되지 않습니다.

자주 발생하는 오류

들여쓰기나 구분 기호가 어긋난 YAML을 입력하면 변환이 성공하지 않습니다. 오류가 나타나면 하위 항목의 간격, 콜론 뒤 값, 목록 표시, 문서 구분 기호를 차례로 고친 다음 다시 실행하세요.

자주 묻는 질문

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

입력이 비어 있거나 공백만 있으면 변환은 성공하고 빈 JSON 객체가 결과로 생성됩니다. 데이터를 바꾸려던 상황이라면 실행 전에 입력란에 내용이 남아 있는지 확인하세요.

중첩 구조와 목록도 변환할 수 있나요?

매핑, 중첩 매핑, 시퀀스가 포함된 YAML은 JSON 텍스트로 직렬화할 수 있습니다. 결과에서는 매핑이 객체 구조로, 시퀀스가 배열 형태로 표현됩니다.

변환에 실패하면 무엇을 확인해야 하나요?

YAML 문법이 올바르지 않으면 성공한 JSON 결과가 생성되지 않습니다. 입력의 들여쓰기와 구분 기호를 수정한 뒤 다시 변환하고, 직렬화할 수 없는 값이 있는지도 살펴보세요.