본문으로 건너뛰기
SPCXTools

YAML JSON 변환기

구문 검사 기능을 통해 YAML과 JSON 구성 파일을 양방향으로 변환하세요.

로컬 실행 — 파일이 기기 외부로 전송되지 않습니다

도구 불러오는 중…

YAML JSON 변환기 사용 방법

  1. 1변환 방향을 선택하세요 — YAML → JSON 또는 JSON → YAML.
  2. 2왼쪽 입력창에 YAML이나 JSON을 붙여넣거나 샘플을 클릭하세요.
  3. 3입력과 동시에 변환된 결과가 오른쪽에 나타납니다. 구문 오류가 발생하면 아래에 설명과 함께 표시됩니다.
  4. 4결과를 복사하거나 .json 또는 .yaml 파일로 다운로드하세요. 변환 방향을 바꾸면 결과값이 입력창으로 이동합니다.

YAML JSON 변환

YAML과 JSON은 설정 및 구조화된 데이터에 가장 많이 사용되는 두 가지 형식입니다. Kubernetes 매니페스트, Docker Compose 파일, CI 파이프라인 및 OpenAPI 스펙은 주로 YAML로 작성되는 반면, API, JavaScript 코드 및 많은 도구는 JSON을 사용합니다. 이 변환기는 입력하는 즉시 실시간으로 양방향 변환을 수행하며, 입력값이 유효하지 않을 경우 정확한 오류 원인을 알려줍니다.

주요 기능

  • 양방향 변환: YAML → JSON 및 JSON → YAML, 원클릭 전환 지원.
  • 구문 검사: 잘못된 들여쓰기, 닫히지 않은 따옴표, 유효하지 않은 JSON에 대한 명확한 오류 메시지 제공.
  • 다중 문서 YAML: JSON 배열로 변환.
  • 앵커, 별칭 및 병합 키 자동 처리.
  • 2칸 또는 4칸 들여쓰기 출력 지원.
  • 복사 및 다운로드: 결과를 .json 또는 .yaml 파일로 복사하거나 다운로드.
  • 개인정보 보호: 서버로 데이터를 전송하지 않습니다.

예시

다음 YAML 코드는:

name: web-app
replicas: 3
ports:
  - 80
  - 443
env:
  NODE_ENV: production

아래와 같은 JSON으로 변환됩니다:

{
  "name": "web-app",
  "replicas": 3,
  "ports": [80, 443],
  "env": {
    "NODE_ENV": "production"
  }
}

자주 하는 YAML 실수

  • 들여쓰기에 탭 사용. YAML은 공백만 허용합니다. 탭을 공백 두 칸으로 변경하세요.
  • 일관성 없는 들여쓰기. 같은 계층의 항목은 정확히 동일한 간격으로 들여쓰기해야 합니다.
  • 콜론 뒤 공백 누락. key:value는 하나의 문자열로 인식되므로 key: value처럼 작성해야 합니다.
  • 문자열 내 특수문자. @, *, &, !, %, {, [로 시작하거나 : 를 포함하는 값은 따옴표로 묶어야 합니다.
  • 의도치 않은 타입 변환. 1.10 같은 버전 번호는 숫자 1.1로 인식되며, 앞자리의 0이 사라질 수 있습니다. 텍스트로 유지해야 하는 값은 반드시 따옴표로 묶어주세요.

관련 도구

결과 JSON을 JSON 포매터로 보기 좋게 정렬하거나 압축해 보세요. JSON CSV 변환기를 사용해 JSON을 스프레드시트로 변환하거나, 텍스트 비교기로 두 설정 파일을 비교할 수도 있습니다.

자주 묻는 질문 (FAQ)

YAML과 JSON의 차이는 무엇인가요?
두 형식 모두 객체, 리스트, 문자열, 숫자, 불리언, null 등 동일한 종류의 데이터를 표현합니다. JSON은 중괄호, 대괄호, 따옴표를 사용하며 API의 표준으로 쓰입니다. YAML은 괄호 대신 들여쓰기를 사용하고 주석을 지원하며, Docker Compose, Kubernetes, GitHub Actions, Ansible 같은 설정 파일에 주로 사용됩니다.
YAML 주석은 어떻게 처리되나요?
JSON은 주석을 지원하지 않으므로 YAML을 JSON으로 변환할 때 주석이 모두 삭제됩니다. 따라서 다시 YAML로 변환하더라도 원래의 주석은 복구되지 않습니다.
여러 개의 YAML 문서는 어떻게 처리되나요?
YAML 파일은 ---로 구분하여 여러 개의 문서를 포함할 수 있습니다. 이 경우 변환기는 각 문서를 요소로 갖는 하나의 JSON 배열을 출력합니다.
앵커(Anchor)와 별칭(Alias)을 지원하나요?
네. 앵커(&name), 별칭(*name), 병합 키(<<: *name)가 모두 해석되므로, JSON에는 완전히 확장된 값이 포함됩니다.
"no"가 false로 바뀌는 등 값의 데이터 타입이 변경되는 이유는 무엇인가요?
이 도구는 true와 false만 불리언(Boolean)으로 인식하는 YAML 1.2 표준을 따릅니다. 구형 YAML 1.1 파서에서는 yes, no, on, off도 불리언으로 처리합니다. 값을 문자열로 유지하려면 따옴표로 묶어주세요.
내 데이터가 서버로 업로드되나요?
아닙니다. 파싱 및 변환 작업이 모두 브라우저 내에서 이루어지므로, 보안 정보나 내부 호스트 이름이 포함된 설정 파일이 기기 외부로 유출되지 않습니다.