YAML ↔ JSON 양방향 변환기

설정 파일을 변환하기 전에 확인하세요

YAML 설정과 JSON 데이터를 오가며 자료형과 중첩 구조를 확인하는 도구입니다. YAML → JSON은 왼쪽 입력으로 오른쪽을 덮어쓰고, JSON → YAML은 오른쪽 입력으로 왼쪽을 덮어씁니다. 원본 주석과 서식을 되돌리는 편집기는 아니므로 원본 파일은 별도로 보관하세요.

변환할 형식의 입력창에 데이터를 넣으세요. 처음이라면 ‘예제 불러오기’로 아래 예시를 직접 실행할 수 있습니다.
해당 방향의 변환 버튼을 누르세요. 결과는 선택한 2칸 또는 4칸 들여쓰기로 표시됩니다.
숫자·문자열·불리언을 확인하고 복사하세요. 실패하면 반대편의 이전 내용은 그대로 유지되며, 오류 메시지가 표시됩니다.

포트와 버전은 같은 숫자처럼 보여도 다릅니다

YAML 입력

service:
  name: demo
  port: 8080
  enabled: true
  version: "1.0"
  tags:
    - api
    - test

JSON 출력

{
  "service": {
    "name": "demo",
    "port": 8080,
    "enabled": true,
    "version": "1.0",
    "tags": ["api", "test"]
  }
}

8080은 숫자, true는 불리언, "1.0"은 문자열로 유지됩니다. 우편번호·식별자처럼 앞자리 0이나 자릿수 자체가 중요한 값은 따옴표로 감싸세요. 이 도구는 js-yaml의 CORE_SCHEMA를 사용하므로 날짜 표기 2026-09-21을 자동으로 Date 객체로 바꾸지 않습니다. yes와 on은 문자열이고 true와 false는 불리언입니다.

변환 과정에서 사라지거나 지원하지 않는 것

주석과 서식: YAML의 # 설명, 빈 줄, 인용 방식, 원래 들여쓰기는 JSON에 보존되지 않습니다. 다시 YAML로 바꿔도 원본 문서와 같지 않을 수 있습니다.
여러 YAML 문서: ---로 나뉜 문서는 다중 문서 옵션으로 변환하세요. 기본은 단일 문서입니다. 다중 문서 옵션을 켜면 최대 100개 문서를 JSON 배열로 묶습니다.
태그와 앵커: 사용자 정의 태그, 집합·바이너리 등 추가 YAML 자료형은 지원하지 않습니다. 앵커 참조는 일반 값으로 펼쳐지며 순환 참조는 오류로 처리합니다. 복합 매핑 키는 문자열로 바뀔 수 있어 사용하지 않는 것이 좋습니다.
숫자 범위: NaN·Infinity와 안전한 정수 범위 밖의 값은 변환을 중단합니다. JavaScript 숫자를 사용하므로 매우 정밀한 소수나 16자리 이상의 식별자는 문자열로 표현하세요.

여러 설정 문서를 한 번에 옮기는 방법

Kubernetes 매니페스트처럼 ---로 나뉜 입력은 ‘다중 문서 ↔ JSON 배열’을 켜면 문서 순서 그대로 배열이 됩니다. JSON에서 YAML로 돌릴 때는 배열의 각 항목을 별도 문서로 내보냅니다. 일반 배열을 하나의 YAML 목록으로 바꾸려면 옵션을 꺼 두세요.

kind: Service
metadata:
  name: demo
---
kind: Deployment
metadata:
  name: demo

위 예제는 Service와 Deployment 두 객체의 JSON 배열로 변환됩니다. 빈 YAML 문서도 null 요소로 보존됩니다. 문서가 100개를 넘거나 참조 확장 후 4 MiB를 넘으면 중단합니다. ‘저장’ 버튼은 해당 편집창의 현재 텍스트를 저장하므로 수정 후에는 먼저 변환으로 문법을 확인하세요.

오류 메시지를 읽는 순서

YAML 들여쓰기: 탭 대신 공백을 쓰고 같은 단계의 키를 같은 열에 놓으세요. 중복 키는 하나로 정리하세요.
JSON 문법: 키와 문자열에 큰따옴표를 쓰고 마지막 항목 뒤 쉼표를 지우세요. JSON은 주석을 받지 않습니다.
변환 엔진 로드 실패: 네트워크 또는 콘텐츠 차단 설정을 확인한 뒤 새로고침하세요. 입력은 자동 저장되지 않습니다.
내용 없는 문서: 주석만 있는 YAML은 변환 대상이 없습니다. 명시적인 빈 값이 필요하면 null을 입력하세요.

변환 성공과 설정 유효성은 다릅니다

JSON으로 변환되었다고 Kubernetes, Docker Compose 또는 GitHub Actions 설정이 올바르다는 뜻은 아닙니다. 이 도구는 데이터 문법과 표현 가능한 자료형을 확인하며 필수 필드, 서비스 이름, API 버전, 권한 설정을 검증하지 않습니다. 실제 적용 전 해당 도구의 검증 명령이나 스키마 검사로 확인하세요.

한 번에 최대 1 MiB의 텍스트를 처리합니다. 큰 데이터나 비밀 정보가 포함된 설정은 로컬 개발 도구를 사용하세요. 사용 중인 js-yaml 4.1.1 문서

🔄 YAML ↔ JSON 양방향 변환기