JSON ↔ YAML 변환기

이 도구는 무엇인가요?

YAML은 오늘날 대부분의 설정 파일이 선택하는 형식입니다. Kubernetes 매니페스트, Docker Compose, GitHub Actions와 GitLab CI 파이프라인, Ansible 플레이북 등이 대표적입니다. 대부분의 키에 따옴표가 필요 없고, 마지막 쉼표 실수도 걱정할 필요 없으며, 주석까지 지원되기 때문에 사람이 손으로 편집하기에는 JSON보다 훨씬 읽기 편합니다. 반면 JSON은 대부분의 API와 프로그래밍 언어가 네이티브로 생성하고 소비하는 형식입니다.

이 도구는 YAML 스펙의 널리 쓰이는 자바스크립트 구현체인 js-yaml을 기반으로 YAML 사양을 따르므로, kubectl이나 CI 러너 같은 YAML 인식 도구가 적용하는 것과 동일한 규칙으로 파싱과 생성이 이루어집니다.

JSON을 YAML로 변환하면 객체는 들여쓰기된 key: value 블록이 되고 배열은 `-`로 시작하는 목록 항목이 됩니다. YAML을 JSON으로 변환하면 그 반대 작업을 하며, 동시에 따옴표 없는 `true`, `null`, 숫자 같은 YAML 고유의 타입 축약 표현을 올바른 JSON 타입으로 풀어줍니다.

왜 사용해야 할까요?

• 양방향 지원 — 같은 화면에서 JSON을 YAML로, 또는 YAML을 JSON으로 변환할 수 있습니다.
• js-yaml 기반의 표준 준수 파싱 및 생성 — Kubernetes, CI 시스템, Ansible 같은 실제 YAML 도구가 기대하는 결과와 일치합니다.
• 어떤 깊이든 중첩된 객체와 배열을 처리하며, YAML의 들여쓰기 기반 구조와 JSON의 중괄호·대괄호 구조를 정확히 오갑니다.
• YAML의 타입 축약 표현을 정확히 해석합니다 — 따옴표 없는 true/false, null, 숫자 값이 문자열이 아니라 올바른 JSON 타입으로 변환됩니다.
• 클립보드 복사 또는 .json / .yaml 파일로 다운로드할 수 있습니다.
• 100% 클라이언트 측 처리 — 붙여넣은 어떤 데이터도 어디에도 업로드되지 않습니다.

사용 방법

1. 방향을 선택하세요: "JSON → YAML" 또는 "YAML → JSON".
2. 입력창에 데이터를 붙여넣으세요.
3. "변환"을 클릭하세요.
4. 결과를 확인한 뒤 복사하거나 "다운로드"를 눌러 파일로 저장하세요.

예시

입력

{"name":"Alice","roles":["admin","editor"],"active":true}

결과

name: Alice
roles:
  - admin
  - editor
active: true

배열이 "roles" 아래에 대시로 시작하는 목록이 되고, 불리언 값은 문자열 "true"가 아니라 따옴표 없는 true 그대로 유지되는 점을 확인하세요.

실전 팁

• Kubernetes 매니페스트나 GitHub Actions 워크플로를 작성할 때: 먼저 JSON으로 구조를 잡고(많은 에디터와 AI 도구가 JSON을 더 안정적으로 생성합니다) 최종 파일은 YAML로 변환하세요.
• 말썽을 부리는 YAML 설정을 디버깅할 때: JSON으로 변환해보면 어떤 값이 문자열, 숫자, 불리언인지 정확히 보입니다 — YAML의 유연한 문법은 JSON에서는 명확히 드러나는 타입 불일치를 숨기기 쉽습니다.
• JSON에 특수문자가 포함된 키나 숫자로 시작하는 키가 있다면, js-yaml이 YAML 출력에서 자동으로 따옴표를 붙여 나중에 다시 올바르게 파싱되도록 처리합니다.

타입 강제 변환이 YAML에서 가장 까다로운 이유

대부분의 값에 따옴표가 필요 없다는, JSON 대비 YAML의 가장 큰 사용성 장점은 동시에 미묘한 버그의 가장 큰 원인이기도 합니다. 대표적인 예가 '노르웨이 문제'입니다. 많은 구식 파서가 따르는 YAML 1.1에서는 따옴표 없는 값 `no`가 문자열 "no"가 아니라 불리언 `false`로 해석되는데, 이 때문에 실제로 노르웨이 국가 코드를 나열하는 설정이 깨진 사례가 있었습니다. 이 도구는 YAML 1.2 사양을 따르며, 따옴표 없이 불리언으로 해석되는 값의 범위를 `true`와 `false`(및 그 대소문자 변형)로 좁혀서 이런 종류의 뜻밖의 결과를 줄여줍니다(완전히 없애지는 못합니다). 값이 어떻게 타입 지정될지 확신이 서지 않는다면, YAML에서 명시적으로 따옴표를 붙이는 것이 가장 안전한 선택입니다.

자주 묻는 질문