- 변환 방향(JSON → YAML 또는 YAML → JSON)을 선택합니다.
- 왼쪽 입력창에 변환할 내용을 붙여넣으면 오른쪽에 결과가 실시간으로 나타납니다.
- 형식이 잘못된 경우 아래에 오류 내용이 표시되니 해당 부분을 수정하세요.
- "결과 복사" 또는 "다운로드"로 변환 결과를 저장합니다. "⇄ 입력·결과 바꾸기"로 방향을 빠르게 뒤집을 수 있습니다.
둘 다 데이터를 구조적으로 담는 형식이지만 모양과 용도가 다릅니다. 같은 데이터를 서로 바꿔 쓸 수 있습니다.
- JSON: 중괄호·대괄호와 따옴표로 표현. 기계가 주고받기 좋아 API·패키지 설정에 쓰입니다.
- YAML: 들여쓰기로 계층을 표현. 사람이 읽고 쓰기 좋아 도커·깃허브 액션·쿠버네티스 설정에 쓰입니다.
- 주석: YAML은 #로 주석을 달 수 있지만 JSON은 주석을 지원하지 않습니다.
설정 파일을 다른 도구로 옮길 때 이 변환이 편합니다. 차이와 함정은 JSON vs YAML 가이드에 정리했습니다.
- 설정 파일 형식 맞추기: 도커 컴포즈, 깃허브 액션, 쿠버네티스 매니페스트는 YAML을 쓰고, 많은 API 응답·패키지 설정은 JSON을 씁니다. 한쪽 형식으로 받은 설정을 다른 도구에 넣어야 할 때 그대로 변환해 옮길 수 있습니다.
- 가독성 좋은 형태로 검토: 중첩이 깊은 JSON은 한눈에 보기 어렵습니다. YAML로 바꾸면 들여쓰기로 계층이 드러나 구조를 빠르게 파악할 수 있고, 반대로 YAML을 JSON으로 바꾸면 프로그램에 바로 넣기 좋은 형태가 됩니다.
- 문법 검증 용도: 변환이 성공하면 입력한 JSON·YAML이 문법적으로 유효하다는 뜻입니다. 오류 메시지가 뜨면 줄 위치를 단서로 누락된 따옴표, 잘못된 들여쓰기, 남은 쉼표 등을 찾아 고칠 수 있습니다.
입력이 선택한 형식의 문법에 맞지 않을 때 발생합니다. JSON은 키와 문자열을 큰따옴표로 감싸야 하고 마지막 쉼표를 허용하지 않습니다. YAML은 들여쓰기에 탭 대신 공백을 사용해야 하며 단계가 일정해야 합니다. 오류 메시지에 표시된 줄·위치를 확인해 해당 부분을 고치면 됩니다.
키의 순서는 대체로 유지되지만, YAML을 JSON으로 변환하면 주석(#로 시작하는 줄)은 사라집니다. JSON 자체가 주석을 지원하지 않기 때문입니다. 반대로 JSON을 YAML로 바꿀 때는 데이터 구조만 옮겨지며 원본에 없던 주석이 새로 생기지는 않습니다.
안전합니다. 변환은 전적으로 브라우저 안의 자바스크립트로 이뤄지며, 입력한 내용은 어떤 서버로도 전송되지 않습니다. API 키나 비밀번호가 담긴 설정 파일을 변환할 때도 데이터가 외부로 빠져나가지 않으니 안심하고 사용할 수 있습니다.
YAML 표준은 들여쓰기에 탭을 금지하고 공백만 허용합니다. 탭은 편집기마다 너비가 달라 계층이 어긋날 수 있기 때문입니다. 들여쓰기 오류가 자주 나면 편집기에서 탭을 공백으로 바꾸는 설정을 켜 두세요.
사람이 자주 읽고 수정하는 설정 파일은 주석과 들여쓰기가 편한 YAML이, 프로그램끼리 데이터를 주고받는 용도는 엄격하고 파싱이 빠른 JSON이 적합합니다. 사용하는 도구가 요구하는 형식에 맞추면 됩니다.