JSON ↔ YAML 변환기（양방향）

왼쪽에 JSON을 붙여넣으면 오른쪽에서 YAML을 얻고, 반대도 마찬가지입니다. 양쪽 패널 모두 실시간 편집이 가능하고 자동으로 동기화됩니다. JSON 포맷, 스왑, 복사 버튼 포함. 모든 변환은 브라우저 내에서만 실행되어 데이터가 서버로 전송되지 않습니다.

tools.json-to-yaml-converter.label.json

tools.json-to-yaml-converter.label.yaml

작동 방식

JSON과 YAML의 역사와 활용

JSON(JavaScript Object Notation)은 2000년대 초 Douglas Crockford가 JavaScript 객체 리터럴 문법을 기반으로 설계한 데이터 교환 형식입니다. 엄격한 이중 따옴표, 쉼표, 괄호 규칙으로 모호함이 없어 거의 모든 언어에 기본 파서가 내장되어 있습니다. 간결성 덕분에 XML을 대체하여 웹 API의 표준 데이터 형식이 되었습니다.

YAML(YAML Ain't Markup Language)은 2001년 Clark Evans와 Ingy döt Net이 인간 친화적인 직렬화 형식을 목표로 만들었습니다. YAML 1.2는 JSON의 완전한 상위 집합으로, 유효한 JSON은 모두 유효한 YAML입니다. 주석, 들여쓰기 기반 계층, 여러 줄 문자열, 타입 추론 기능을 추가하여 사람이 직접 편집하는 설정 파일에 특히 적합합니다.

JSON과 YAML의 사용 기준

JSON은 기계가 데이터를 소비하는 환경에 최적화되어 있습니다. REST API, 데이터베이스 레코드, 서비스 간 통신, 로컬 스토리지 등이 그 예입니다. 엄격한 문법은 모든 언어에서 동일한 파싱 동작을 보장하며, 코드가 주 소비자라면 JSON이 대부분 최선의 선택입니다.

YAML은 개발자가 직접 편집하는 설정 파일에 강점을 발휘합니다. Docker Compose, Kubernetes 매니페스트, GitHub Actions 워크플로, Ansible 플레이북 등이 YAML을 기본으로 사용합니다. 주석으로 인라인 문서화가 가능하고, 괄호 없는 계층 구조가 설정 파일을 더 읽기 편하게 만듭니다.

변환 시 주의해야 할 함정

YAML의 들여쓰기 민감성이 가장 일반적인 오류 원인입니다. JSON의 괄호와 달리 공백 하나의 차이가 전체 구조를 바꿉니다. 또한 YAML은 자동으로 타입을 추론하는데, 예를 들어 yes는 불리언 true로, 0755는 8진수로 해석될 수 있습니다. 이 도구는 원본 타입을 유지하기 위해 오해받을 수 있는 문자열에 자동으로 따옴표를 추가합니다.

특수 문자도 주의해야 합니다. 콜론 뒤에 공격(: ), 해시(#), 중괄호({, [)로 시작하는 문자열은 YAML에서 따옴표로 감싸야 합니다. 이 도구는 이런 경우를 자동으로 처리하지만, 앵커, 별칭, 여러 줄 블록 스칼라 같은 고급 YAML 기능은 지원하지 않으며 명확한 오류 메시지를 표시합니다.

자주 묻는 질문

›YAML은 JSON의 상위 집합인가요?

네. YAML 1.2는 JSON의 엄격한 상위 집합으로, 유효한 JSON 문서는 모두 유효한 YAML입니다. 반대는 항상 성립하지 않습니다. YAML의 주석, 앵커, 블록 스칼라는 JSON에 대응물이 없습니다.

›YAML은 주로 어디에 사용되나요?

주로 설정 파일에 사용됩니다. Docker Compose, Kubernetes 매니페스트, GitHub Actions, Ansible 플레이북 등이 대표적입니다. 개발자가 직접 편집하는 파일에 YAML의 가독성이 빛을 발합니다.

›설정 파일에는 JSON과 YAML 중 무엇이 더 적합한가요?

사람이 편집할 때는 YAML이 더 편리합니다. 주석을 지원하고 시각적 계층이 명확하기 때문입니다. 기계 생성·소비 설정에는 JSON이 더 엄격합니다. ESLint, Prettier, tsconfig 등 많은 도구가 두 형식을 모두 지원합니다.

›YAML에서 특수 문자는 어떻게 처리되나요?

콜론+공백(: ), 앞에 오는 특수 기호({, [, #), 불리언이나 숫자로 보이는 값은 따옴표로 감싸야 합니다. 단따옴표는 이스케이프를 비활성화하고, 쌍따옴표는 JSON과 유사한 백슬래시 이스케이프를 사용합니다. 이 도구는 필요한 곳에 자동으로 따옴표를 추가합니다.

›JSON에서 YAML로의 변환은 무손실인가요?

JSON이 지원하는 타입(문자열, 숫자, 불리언, null, 객체, 배열)에 대해서는 무손실입니다. YAML의 타입 추론으로 인한 데이터 변형을 방지하기 위해 오해받을 수 있는 문자열에 자동으로 따옴표를 추가합니다.

›Python에서 YAML을 JSON으로 변환하는 방법은?

PyYAML 라이브러리를 사용합니다: import yaml, json; data = yaml.safe_load(open('file.yaml')); print(json.dumps(data, indent=2)). safe_load는 임의 YAML 태그 실행을 방지하여 더 안전합니다.

›Node.js에서 JSON을 YAML로 변환하는 방법은?

js-yaml 패키지를 사용합니다: const yaml = require('js-yaml'); const obj = JSON.parse(fs.readFileSync('file.json')); console.log(yaml.dump(obj)). 의존성 없는 접근법은 이 도구처럼 직렬화기를 직접 작성하는 것입니다.

›지원하지 않는 YAML 기능은 무엇인가요?

앵커(&name), 별칭(*name), 타입 태그(!!int 등), 여러 줄 블록 스칼라(| 및 >), 문서 구분자(---)는 지원하지 않습니다. 이런 기능이 필요한 경우 완전한 YAML 라이브러리를 사용하세요.