JSON을 YAML로 변환

사용 방법

1. 1

   JSON 붙여넣기

   객체, 배열, 스칼라를 붙여넣거나 샘플(API 응답, 중첩 배열, 경계 사례)을 불러옵니다. 문법 오류가 있으면 출력 대신 오류가 표시됩니다.

2. 2

   들여쓰기 고르기

   쿠버네티스와 GitHub Actions에서 흔한 2칸, 또는 저장소가 쓰는 4칸을 고릅니다.

3. 3

   YAML 1.1 단어 따옴표 정하기

   PyYAML, Ruby 등 YAML 1.1 파서가 읽을 수 있는 파일이면 켜 두세요. YAML 1.2만 쓰는 도구이거나 가장 짧은 출력이 필요하면 끕니다.

4. 4

   따옴표와 여러 줄 텍스트 확인

   따옴표가 붙은 값은 그대로 두면 숫자, 불리언, null, 날짜로 읽힐 문자열입니다. 줄바꿈이 있는 문자열은 |- 블록으로 나오므로 블록 안 들여쓰기를 확인합니다.

5. 5

   복사 또는 저장

   YAML을 복사하거나 파일로 저장해 매니페스트나 설정에 넣습니다.

작동 원리

script: |-
  echo one
  echo two
count: "123"
answer: "yes"
ports:
  - 80
  - 443

실제 예시

{"name":"web","replicas":3,"env":{"LOG_LEVEL":"info","DEBUG":false},"ports":[80,443],"labels":[{"app":"web"},{"tier":"front"}]}

name: web
replicas: 3
env:
  LOG_LEVEL: info
  DEBUG: false
ports:
  - 80
  - 443
labels:
  - app: web
  - tier: front

{"count":"123","flag":"true","nothing":"null","empty":"","colon":"a: b","hash":"#c"}

count: "123"
flag: "true"
nothing: "null"
empty: ""
colon: "a: b"
hash: "#c"

{"answer":"yes","switch":"off","code":"1_000","day":"2024-01-01","name":"Bob"}

answer: "yes"
switch: "off"
code: "1_000"
day: "2024-01-01"
name: Bob

{"answer":"yes","day":"2024-01-01"}

answer: yes
day: 2024-01-01

{"script":"echo one\necho two","none":null,"e":[],"o":{},"list":[{"a":1}]}

script: |-
    echo one
    echo two
none: null
e: []
o: {}
list:
    - a: 1

[1,"a",null]

- 1
- a
- null

자주 하는 실수

• 큰 정수는 변환 전에 반올림됩니다

  파싱한 숫자 토큰을 JavaScript 숫자로 바꾸는 과정에서 9007199254740993이 9007199254740992가 된 뒤 YAML을 씁니다. 아주 큰 ID는 JSON에서 문자열로 두세요.

• 1.1 옵션을 끄면 의미가 바뀔 수 있습니다

  YAML 1.1 단어 따옴표를 끄면 yes, no, on, off와 날짜가 따옴표 없이 쓰입니다. PyYAML과 Psych는 이를 불리언이나 날짜 객체로 읽지만 y, n은 문자열로 둡니다. 읽는 쪽을 모르면 옵션을 켜 두세요.

• 주석은 보존할 수 없습니다

  JSON에는 주석이 없으니 YAML에도 없습니다. 변환한 뒤에 직접 추가하세요.

• 키 순서는 JSON을 따릅니다

  키는 파싱된 순서대로 쓰입니다. "10", "2" 같은 정수형 키는 JavaScript 객체 규칙대로 오름차순으로 맨 앞에 옵니다.

• 중복 JSON 키는 합쳐집니다

  JSON에 같은 키가 두 번 있으면 변환 전에 마지막 값만 남으므로 YAML에도 하나만 나옵니다.

• 출력은 블록 스타일뿐입니다

  들여쓰기는 고를 수 있지만 플로 스타일은 선택할 수 없으므로, 저장소가 더 엄격한 서식을 요구하면 자체 포매터가 필요할 수 있습니다.

자주 묻는 질문

더 깊이 읽기

• 8분 읽기YAML 문법 주의점: Norway 문제, yes/no 불리언, 8진수, 탭과 들여쓰기 오류YAML은 평범한 텍스트처럼 보여서 오히려 사고가 납니다. 같은 글자를 다르게 읽는 두 버전과, 줄에 따라 조용히 또는 시끄럽게 실패하는 들여쓰기 규칙이 대부분의 함정입니다.