YAML ↔ JSON 변환

YAML과 JSON을 서로 변환합니다.

도커 컴포즈나 깃허브 액션 설정을 손보다 보면 들여쓰기 한 칸 때문에 전체가 어긋나는 일이 흔합니다. 이럴 때 JSON으로 한 번 바꿔 보면 구조가 어떻게 해석되고 있는지 한눈에 들어옵니다. 반대로 API 응답 JSON을 사람이 읽기 좋은 설정 파일로 옮겨야 할 때도 있죠. 이 도구는 두 방향 변환을 브라우저 안에서 처리합니다.

어떻게 계산되나요

두 방향 변환

입력창에 붙여넣고 방향 버튼을 누르면 됩니다.

YAML → JSON : YAML을 해석해 들여쓰기 2칸 JSON으로 출력합니다.
JSON → YAML : JSON을 해석해 들여쓰기 2칸 YAML로 출력합니다. 줄 길이 제한 없이 내보내므로 긴 값이 중간에 접히지 않습니다.

문법 검사로 쓰기

변환이 곧 검사입니다. 파싱에 실패하면 결과 대신 오류 메시지가 나오는데, 여기에 문제가 생긴 위치나 원인이 함께 표시됩니다. YAML 들여쓰기 사고가 의심되면 YAML → JSON 을 눌러 나온 구조가 의도한 모양인지 확인해 보세요.

알아 둘 점

항목	동작
주석(`#`)	JSON에 주석이 없어 변환 시 사라집니다
앵커·별칭(`&`, `*`)	실제 값으로 펼쳐져 들어갑니다
여러 문서(`---`)	첫 문서만 변환됩니다
키 순서	입력 순서를 그대로 유지합니다

YAML을 JSON으로 바꿨다가 다시 YAML로 되돌리면 주석과 원래 서식은 남지 않습니다. 원본은 따로 보관하세요.

용어 정리

YAML: 들여쓰기로 계층을 표현하는 설정 파일 형식. 사람이 읽고 쓰기 편해 배포·CI 설정에 많이 쓰입니다.
JSON: 중괄호와 대괄호로 구조를 적는 데이터 형식. 프로그램끼리 주고받기에 적합합니다.
파싱: 텍스트를 규칙에 따라 읽어 프로그램이 다룰 수 있는 구조로 바꾸는 과정.
들여쓰기: 줄 앞의 공백. YAML에서는 계층을 결정하는 문법이며, 탭 문자는 쓸 수 없습니다.
앵커·별칭: YAML에서 같은 값을 `&이름`으로 표시해 두고 `*이름`으로 재사용하는 문법.

자주 묻는 질문

YAML 주석이 변환하면 사라집니다

JSON 규격에 주석이 없어서 옮길 자리가 없습니다. 주석을 살려야 한다면 원본 YAML을 따로 보관하고, 이 도구는 구조 확인이나 일회성 변환용으로 쓰는 편이 좋습니다.

들여쓰기 오류라는데 어디가 문제인지 모르겠어요

오류 메시지에 표시된 줄 번호 부근을 먼저 보고, 탭 문자가 섞였는지 확인하세요. YAML은 탭을 들여쓰기로 인정하지 않습니다. 또 같은 계층의 항목은 공백 개수가 정확히 같아야 합니다.

`---` 로 나뉜 여러 문서를 한 번에 바꿀 수 있나요

첫 문서만 변환됩니다. 쿠버네티스 매니페스트처럼 여러 문서가 이어진 파일이라면 `---` 기준으로 잘라 하나씩 붙여넣으세요.

`yes`, `no`, `on` 이 true/false로 바뀝니다

YAML은 일부 단어를 불리언으로 해석합니다. 글자 그대로 남기려면 `"yes"` 처럼 따옴표로 감싸세요. 국가 코드 `NO`나 버전 번호처럼 보이는 값도 같은 이유로 따옴표가 안전합니다.

붙여넣은 설정이 서버로 전송되나요

아니요. 변환은 브라우저 안에서만 실행되고 입력 내용은 전송·저장되지 않습니다. 다만 비밀키가 든 설정이라면 사용 후 입력창을 비워 두세요.