YAML JSON 변환기
YAML과 JSON을 양방향으로 변환합니다. 중첩 객체, 배열, 여러 줄 문자열을 지원하고 그대로 변환할 수 없는 값은 목록으로 보여 줍니다.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
YAML과 JSON의 구분 사용
YAML은 Docker Compose, Kubernetes, GitHub Actions, Ansible, Helm Charts 등의 설정 파일에 널리 사용됩니다. JSON은 REST API, 웹 브라우저, 프로그램 간 데이터 교환에 적합합니다. 두 형식 간 변환이 필요한 상황에서 활용하십시오.
타입이 바뀌는 값
이 도구는 js-yaml 4.3.2의 기본 스키마를 씁니다. YAML 1.2 core schema에 타임스탬프, << 병합 키, !!binary·!!set·!!omap·!!pairs 태그를 더한 것입니다. 다음 입력은 이렇게 변환됩니다.
| YAML | JSON | 설명 |
|---|---|---|
country: NO | "NO" | 문자열. PyYAML 같은 YAML 1.1 파서는 false로 읽음 |
enabled: yes | "yes" | 위와 같음. 불리언은 true로 쓰기 |
version: 1.10 | 1.1 | 숫자로 해석됨. 버전 문자열은 따옴표로 감싸기 |
mode: 0755 | 755 | YAML 1.2에서 앞의 0은 8진수가 아님. 0o755로 쓰기 |
zip: 01234 | 1234 | 앞의 0이 사라짐. 이런 코드는 따옴표로 감싸기 |
date: 2026-09-29 | "2026-09-29T00:00:00.000Z" | 날짜가 UTC 타임스탬프 전체로 바뀜 |
at: 2026-10-01T09:30:00+09:00 | "2026-10-01T00:30:00.000Z" | 오프셋이 UTC로 바뀜. JSON에는 날짜 타입이 없어 UTC ISO 8601 문자열이 됨. 시각은 같지만 원래 쓴 +09:00은 남지 않음 |
zero: -0.0 | -0.0 | 음수 0은 부호를 유지함(JSON.stringify만 쓰면 0) |
empty: | null | 값이 없는 키는 null |
roles: !!set {admin, editor} | {"admin":null,"editor":null} | js-yaml은 set을 값이 null인 매핑으로 읽음 |
steps: !!pairs [run: build, run: test] | [["run","build"],["run","test"]] | pairs는 [키, 값] 배열이 되며 중복 키도 남음 |
2026-01-01: New Year | {"2026-01-01":"New Year"} | 키로 쓴 날짜는 쓴 그대로의 문자열이 됨. JSON의 키는 문자열 |
제한 사항
-
한 번에 문서 하나만 변환합니다.
---로 구분된 입력은expected a single document in the stream, but found more오류가 납니다. -
JSON이나 YAML로 나타낼 수 없는 값이 있으면 변환하지 않습니다. YAML의
.inf,-.inf,.nan과 양방향 모두 ±(2^53 − 1)을 벗어나는 정수는 변환 중 값이 바뀝니다(JSON.stringify는null로 쓰고,JSON.parse와 js-yaml은 큰 정수를 반올림합니다). 상태 줄에 각 필드를 JSON Pointer로 표시합니다. 다음 YAML은size: .inf id: 9007199254740993변환하지 않았습니다: JSON에서는 다음 값을 바꾸지 않고 나타낼 수 없습니다: /size: inf — JSON으로 나타낼 수 없습니다(JSON.stringify는 null로 씁니다); /id: 정수 9007199254740993 — ±(2^53 − 1) 범위를 벗어나 JavaScript에서 반올림됩니다메시지를 냅니다.1e400처럼 배정밀도 범위를 넘는 JSON 숫자도 같은 방식으로 표시합니다. 큰 ID는 따옴표로 감싸세요. 변환할 수 있는 입력이 될 때까지 출력 패널은 비워지고 복사 버튼은 비활성화됩니다. -
없는 날짜와 밀리초보다 정밀한 시간은 변환하지 않습니다. js-yaml은
Date.UTC로 날짜를 만들기 때문에2026-02-31을 3월 3일로 넘기고, 시간은 밀리초까지만 남깁니다. 이런 타임스탬프가 있으면 변환을 멈춥니다. 다음 YAML은due: 2026-02-31 at: 2026-10-01T09:30:00.123456Z변환하지 않았습니다: JSON에서는 다음 값을 바꾸지 않고 나타낼 수 없습니다: /due: 2026-02-31 — 올바른 날짜나 시각이 아닙니다; /at: 2026-10-01T09:30:00.123456Z — 밀리초보다 정밀합니다메시지를 냅니다. 텍스트로 쓰려는 값은 따옴표로 감싸세요(due: "2026-02-31"). 올바른 날짜와 시간은 위 표처럼 UTC로 변환됩니다. -
!!binary데이터도 변환하지 않습니다. js-yaml은 이를 바이트로 읽지만 JSON에는 바이너리 자료형이 없습니다(JSON.stringify는 바이트 번호를 키로 하는 객체로 씁니다).photo: !!binary aGVsbG8=는변환하지 않았습니다: JSON에서는 다음 값을 바꾸지 않고 나타낼 수 없습니다: /photo: !!binary 값 — JSON에는 바이너리 자료형이 없습니다메시지를 냅니다.!!binary태그를 빼면 Base64 텍스트가 문자열로 변환됩니다.!!binary를 키로 쓴 경우에도 변환하지 않습니다. js-yaml은 이 키를 바이트 값 목록(아래 예에서는107,49)으로 바꿉니다. PyYAML 6.0.3은bytes키를 이렇게 쓰며,yaml.dump({b'k1': 1})의 출력은 다음과 같습니다.? !!binary | azE= : 1도구는
변환하지 않았습니다: JSON에서는 다음 값을 바꾸지 않고 나타낼 수 없습니다: (루트): !!binary 키 azE= — JSON의 키는 문자열만 쓸 수 있습니다메시지를 냅니다.m: {<<: !!binary aGk=}처럼<<로!!binary데이터를 병합해도/m: !!binary aGk= — <<로는 매핑만 병합할 수 있습니다로 멈춥니다. -
js-yaml 처리 한도. js-yaml 4.3.2는 중첩이 100단계를 넘거나, 병합 키(
<<)가 처리하는 매핑과 키가 모두 10,000개를 넘거나, 병합 키 하나에 매핑을 100개 넘게 나열한 문서에서 멈춥니다. 예:유효하지 않은 YAML: 컬렉션 중첩이 100단계를 넘습니다(js-yaml 기본 한도) (1:103). -
중복 키는 오류입니다(
duplicated mapping key). 조용히 덮어쓰지 않습니다. -
주석과 앵커는 남지 않습니다. 앵커와
<<병합 키는 펼쳐져 일반 복사본이 됩니다. -
JSON 정수
-0은0이 됩니다.{"count":-0,"offset":-0.0}은count: 0과offset: -0.0이 됩니다. YAML 1.2는-0을 정수 0으로 읽고,-0.0은 음의 부동소수점 0으로 남습니다. -
JSON → YAML에서는 모호한 문자열에 따옴표를 붙입니다(
'1.10','yes','NO'등). 다시 읽어도 문자열로 남습니다.
관련 도구
변환 전 YAML 구문을 확인하려면 YAML 유효성 검사기, TOML은 TOML JSON 변환기, JSON 쪽 정리는 JSON Formatter를 쓰세요.
FAQ
YAML과 JSON의 차이는 무엇인가요?
YAML은 들여쓰기로 구조를 표현하고, 주석, 여러 줄 문자열, 앵커와 앨리어스를 쓸 수 있어 사람이 읽고 쓰기 쉬운 형식입니다. JSON은 더 엄격하고 기계 처리에 적합합니다. 설정 파일에는 YAML, API에는 JSON이 많이 사용됩니다.
어떤 YAML 기능을 지원하나요?
js-yaml 4.3.2의 기본 스키마를 씁니다. YAML 1.2 core schema에 타임스탬프, << 병합 키, !!binary·!!set·!!omap·!!pairs 태그를 더한 것입니다. 블록·플로 스타일의 중첩 매핑과 시퀀스, 여러 줄 문자열(리터럴 |, 폴디드 >), 앵커와 앨리어스, 문자열·숫자·불리언·null·날짜를 읽습니다. 한 번에 한 문서만 변환할 수 있습니다. CloudFormation의 !Ref 같은 사용자 정의 태그는 unknown tag 오류로 변환을 멈추고, !!binary 데이터도 JSON에 바이너리 자료형이 없어 변환을 멈춥니다. !!set은 값이 null인 객체, !!omap은 키가 하나인 객체의 배열, !!pairs는 [키, 값] 배열의 배열이 됩니다.
YAML의 데이터 타입은 JSON에서 어떻게 바뀌나요?
문자열은 문자열, 숫자는 숫자, 불리언은 true/false, null은 null, 시퀀스와 매핑은 배열과 객체가 됩니다. 날짜는 UTC 기준 ISO 8601 문자열이 되며 +09:00 같은 오프셋은 남지 않습니다. 키로 쓴 날짜는 쓴 그대로의 문자열이, 키로 쓴 정수는 정확한 10진수 문자열이 됩니다(JSON의 키는 문자열입니다). .inf, .nan, ±(2^53 − 1)을 넘는 정수, 2026-02-31처럼 없는 날짜, 밀리초보다 세밀한 시각, !!binary 데이터는 JSON에 그대로 쓸 수 없으므로 변환을 멈추고 해당 필드를 알려 줍니다.
---로 구분한 여러 문서의 YAML도 변환할 수 있나요?
할 수 없습니다. ---로 구분된 입력은 expected a single document in the stream, but found more 오류가 납니다. 한 문서씩 변환하거나, 문서마다 결과를 보여 주는 YAML 유효성 검사기로 확인하세요.
YAML의 주석은 변환 후에도 남나요?
아니요. JSON에는 주석 개념이 없으므로 YAML→JSON 변환 시 주석은 제거되며, JSON을 다시 YAML로 바꿔도 돌아오지 않습니다.
데이터가 서버로 전송되나요?
아니요. 변환은 이 페이지의 JavaScript(js-yaml)가 처리하며, YAML과 JSON은 서버로 전송되지 않고 브라우저 저장소에도 저장되지 않습니다. 이 도구는 사용 이벤트를 보내지 않으며, 페이지 통계는 페이지 조회만 기록합니다.