YAML ↔ JSON 변환기

YAML과 JSON 데이터를 브라우저에서 양방향으로 변환합니다.

카테고리: 변환 도구

언제 사용하나요?

Docker Compose, Kubernetes, GitHub Actions 같은 YAML 설정 파일을 JSON으로 변환하거나, JSON API 응답을 YAML 문서 형식으로 정리할 때 사용합니다. 모든 변환은 브라우저에서만 처리되어 데이터가 외부로 전송되지 않습니다.

사용 방법

  • 변환 방향(YAML → JSON 또는 JSON → YAML)을 선택합니다.
  • 입력란에 변환할 데이터를 붙여넣습니다.
  • 변환 결과를 확인하고 복사합니다.

입력값 안내

YAML은 들여쓰기 기반 형식, JSON은 중괄호 기반 형식입니다. 객체, 배열, 문자열, 숫자, 불리언 값을 지원합니다.

계산·변환 기준

브라우저 내장 JSON 파서와 js-yaml 라이브러리를 사용하여, 들여쓰기 기반의 YAML 문자열을 JS 객체(AST)로 구문 분석한 뒤 JSON 문자열로 직렬화하거나 그 역과정을 수행합니다.

사용 예시

  • 설정 파일 변환 - YAML 설정을 JSON 기반 도구에서 읽을 수 있게 변환합니다.
  • API 예시 정리 - JSON 샘플을 문서용 YAML 형식으로 바꿉니다.
  • 데이터 형식 점검 - YAML이 의도한 JSON 구조로 해석되는지 변환 결과로 확인합니다.

예시

  • YAML: "name: John\nage: 30" → JSON: {"name":"John","age":30}
  • GitHub Actions 워크플로 YAML 붙여넣기 → 들여쓰기 구조 그대로 JSON 객체로 변환
  • JSON: {"host":"localhost","port":5432} → YAML: host: localhost\nport: 5432
  • docker-compose.yml 내용 → JSON으로 변환 후 API 파라미터 검증
  • Kubernetes 설정 YAML → JSON으로 변환 후 jq 명령으로 필드 추출
  • 복잡한 중첩 YAML 설정 → JSON으로 변환하여 구조 파악 및 오류 검출

주의사항

  • 입력 데이터는 브라우저에서만 처리되며 서버로 전송되지 않습니다.
  • YAML 앵커(&)나 병합 키(<<) 같은 고급 기능은 지원하지 않을 수 있습니다.
  • 인코딩 표준(UTF-8)이 맞지 않거나 복잡한 중첩 구조를 가진 소스 데이터를 변환할 경우 데이터 구조가 깨지거나 누락될 수 있습니다.

계산·사용 가이드

YAML과 JSON 차이

JSON은 중괄호와 따옴표 중심의 엄격한 데이터 형식이고, YAML은 들여쓰기 기반으로 사람이 읽기 편한 형식입니다.

변환 전 문법 확인

YAML은 들여쓰기와 콜론 위치에 민감합니다. 변환 오류가 나면 들여쓰기, 배열 표기, 문자열 따옴표를 먼저 확인하세요.

자주 묻는 질문

변환이 서버로 전송되나요?

아니요. 입력 데이터는 브라우저에서만 파싱하고 변환합니다.

복잡한 YAML도 처리하나요?

일반적인 객체, 배열, 문자열, 숫자, 불리언 값을 지원합니다.

주석은 어떻게 처리되나요?

YAML 주석은 JSON에 대응되는 표현이 없어 JSON으로 변환하면 사라집니다.

들여쓰기가 틀리면 어떻게 되나요?

YAML은 들여쓰기로 구조를 표현하므로, 들여쓰기가 어긋나면 파싱 오류가 표시됩니다.

관련 도구