YAML/JSON 변환기

JSON ↔ YAML을 한 페이지에서 바꿉니다. 설정 파일을 읽기 쉽게 만들거나, 매니페스트를 코드에서 다루기 쉬운 JSON으로 옮길 때 씁니다. 처리는 전부 로컬입니다.

검증된 왕복

JSON {"name":"모듈","tags":["a","b"]} → YAML:

name: 모듈
tags:
  - a
  - b

다시 JSON으로 돌리면 동등한 객체가 됩니다. 키 표시 순서는 직렬화 과정에서 달라질 수 있으므로, 텍스트 diff 전에는 JSON 포매터 정렬 모드로 맞추세요.

방향 선택

탭/스페이스 혼용, 따옴표 없는 : , 잘못된 들여쓰기가 잦은 실패 원인입니다.

한계

매우 큰 문서, 순환 참조, YAML 태그·바이너리 타입은 단순 JSON 값으로 줄어들거나 실패할 수 있습니다. undefined에 가까운 값은 null로 보일 수 있습니다. 비밀번호가 들어 있는 시크릿 매니페스트는 예제 값으로만 테스트하세요.

관련 읽기: JSON 문법 가이드, 데이터 워크벤치.

실무 시나리오 세 가지

시나리오 A: API 응답을 배포 설정으로. 스테이징 API에서 받은 JSON을 YAML로 바꿔 문서 저장소에 둡니다. 사람이 주석을 달아야 한다면 YAML 변환 후 편집기에서 # 주석을 추가합니다. 다시 JSON으로 돌리면 주석은 사라지므로, 주석이 있는 파일을 진실 공급원으로 삼으세요.

시나리오 B: 들여쓰기 오류 디버깅. CI가 YAML 파싱에 실패하면 오류 본문을 이 도구에 붙여 넣어 행·열을 확인합니다. 탭이 섞였거나 목록 표시 - 들여쓰기가 어긋난 경우가 많습니다.

시나리오 C: JSON만 받는 도구에 YAML 전달. 외부 CLI가 JSON만 받으면 YAML → JSON 후 파이프합니다. 변환 전후에 JSON 포매터로 스키마 모양을 눈으로 검수합니다.

YAML에서 자주 깨지는 값

따옴표 없이 01을 쓰면 일부가 숫자 1로 해석될 수 있습니다. 전화번호·코드는 따옴표로 감싸세요. true/false/null도 예약 의미로 읽힐 수 있어, 그 문자 그대로가 필요하면 문자열로 명시합니다. JSON으로 바꾼 뒤 타입이 예상과 같은지 반드시 확인하세요.

워크벤치와의 관계

같은 변환이 데이터 워크벤치에도 모드로 들어 있습니다. 이 전용 페이지는 YAML↔JSON만 집중할 때, 워크벤치는 JSON·CSV·URL·Base64·해시를 이어서 처리할 때 유리합니다. 민감 값은 어느 쪽에도 붙여 넣지 않는 습관을 유지하세요.

JSON만 다루는 동료와 협업할 때

YAML을 선호하는 인프라 팀과 JSON만 받는 애플리케이션 팀이 섞여 있으면, 이 변환기가 경계가 됩니다. YAML 원본을 저장소에 두고 필요할 때만 JSON으로 바꾸면 주석과 읽기 쉬운 구조를 유지할 수 있습니다. 반대로 애플리케이션이 내보낸 JSON을 운영자가 읽게 하려면 JSON → YAML이 적합합니다.

변환 후 반드시 타입을 확인하세요. 따옴표 없는 버전: 01이 숫자로 바뀌거나, 국가: NO가 불리언으로 오해될 여지는 파서·스키마에 따라 달라집니다. 의심스러운 값은 따옴표로 감싼 뒤 다시 변환합니다.

대용량 크론 설정·Helm 값 파일은 샘플만 이 페이지에서 검증하고, 본 변환은 CI 스크립트로 고정하세요. 브라우저 탭은 탐색용입니다.