JSON ↔ YAML 변환
JSON 과 YAML 상호 변환
🔒 이 도구는 입력한 데이터를 서버로 전송하지 않습니다. 모든 변환·계산은 여러분의 브라우저 안에서만 실행되므로 민감한 데이터도 안전하게 처리할 수 있습니다.
JSON ↔ YAML 변환이란?
YAML은 들여쓰기로 계층을 표현하는 사람 친화적인 설정 형식으로, Docker Compose·Kubernetes·GitHub Actions·각종 CI 설정에서 표준처럼 쓰입니다. 반면 프로그램 내부나 API에서는 JSON이 더 흔합니다. 이 도구는 두 형식을 양방향으로 변환해, JSON으로 받은 값을 YAML 설정에 옮기거나, YAML 설정을 코드에서 쓰기 좋은 JSON으로 바꿀 때 사용합니다.
사용 방법
- 변환 방향(JSON→YAML 또는 YAML→JSON)을 고릅니다.
- 입력창에 원본을 붙여넣고 변환 버튼을 누릅니다.
- 변환된 결과를 확인하고 복사해 설정 파일에 붙여넣습니다.
실무 활용 예시
- CI/CD 설정 — 문서에 JSON으로 적힌 예시를 GitHub Actions·GitLab CI용 YAML로 옮깁니다.
- Kubernetes 매니페스트 — 도구가 JSON으로 뱉은 리소스 정의를 사람이 읽기 좋은 YAML로 정리합니다.
- 설정 통합 — YAML로 관리하던 환경 설정을 애플리케이션이 파싱하기 쉬운 JSON으로 변환합니다.
팁과 주의점
- YAML은 들여쓰기에 매우 민감합니다. 탭 대신 공백을 사용하고 계층마다 칸 수를 일정하게 맞추세요.
yes/no,on/off같은 문자열이 YAML에서 불리언으로 해석될 수 있으니 필요하면 따옴표로 감쌉니다.- 변환은 브라우저 안에서만 이뤄지므로 비밀 키가 포함된 설정도 외부로 전송되지 않습니다. 다만 실제 비밀값은 결과를 저장소에 커밋하기 전에 반드시 분리하세요.
자주 묻는 질문
YAML의 주석(#)도 변환되나요?
JSON은 주석을 지원하지 않으므로 YAML→JSON 변환 시 주석은 사라집니다. 반대로 JSON→YAML 변환에서는 원본에 주석이 없으니 생성되지 않습니다.
들여쓰기 오류가 있는 YAML은 어떻게 되나요?
파싱 단계에서 오류가 감지되면 결과 대신 어느 줄에서 문제가 생겼는지 메시지로 안내합니다. 탭 문자와 정렬 불일치가 가장 흔한 원인입니다.
멀티 도큐먼트 YAML(--- 구분)도 지원하나요?
기본 변환은 단일 도큐먼트를 대상으로 합니다. 여러 문서가 --- 로 구분된 경우 문서를 나눠 개별적으로 변환하는 것이 안전합니다.
입력값이 서버로 전송되나요?
아니요. 변환은 브라우저에서만 수행되며 어떤 데이터도 서버로 보내지 않습니다.