JSON과 YAML, 같은 데이터를 다르게 표현하는 두 방식

JSON과 YAML은 표현할 수 있는 데이터 구조(객체, 배열, 문자열, 숫자, 불리언)가 사실상 동일합니다. 그런데도 API 응답에는 JSON이, 설정 파일에는 YAML이 압도적으로 많이 쓰이는 데는 이유가 있습니다. JSON은 중괄호와 대괄호, 쉼표로 구조를 명확히 표시하기 때문에 기계가 파싱하기 쉽고, 대부분의 프로그래밍 언어에서 표준 라이브러리 수준으로 지원됩니다. 이런 명확함 덕분에 API 요청/응답처럼 프로그램 간에 데이터를 주고받는 용도에 적합합니다. 반면 YAML은 들여쓰기로 구조를 표현해 중괄호나 쉼표가 없어 사람이 눈으로 읽고 수정하기에 훨씬 편합니다. 이 때문에 Kubernetes 매니페스트, CI/CD 파이프라인, 애플리케이션 설정 파일처럼 사람이 직접 작성하고 리뷰하는 문서에 널리 쓰입니다. 다만 YAML은 들여쓰기 오류에 민감하다는 단점이 있습니다. 탭과 스페이스가 섞이거나 들여쓰기 칸 수가 한 칸만 틀려도 전혀 다른 구조로 해석되거나 파싱 오류가 발생합니다. 또한 YAML의 유연한 문법(따옴표 생략, 자동 타입 추론) 때문에 "no"라는 문자열을 불리언 false로 잘못 해석하는 등 예상치 못한 타입 변환 문제가 생기기도 합니다. 이 사이트의 JSON/YAML 변환기는 JSON을 YAML로, YAML을 JSON으로 즉시 상호 변환할 수 있고, JSON 포맷팅(들여쓰기 정리) 기능도 함께 제공합니다. 설정 파일을 다른 포맷으로 옮기거나, 두 포맷을 비교하며 구조를 파악할 때 활용해 보시기 바랍니다.