YAML-JSON 변환

🔄 YAML ↔ JSON 변환기란?

YAML과 JSON을 양방향으로 즉시 변환합니다. YAML은 들여쓰기 기반으로 사람이 읽기 쉽고, JSON은 중괄호와 따옴표로 기계 처리에 적합합니다.Docker Compose, Kubernetes, GitHub Actions 같은 설정 파일과 API 응답 분석에 바로 활용하세요.

📋 YAML vs JSON 비교

🔄 같은 설정, 두 가지 표기

동일한 데이터를 두 포맷으로 써보면 왜 설정 파일에 YAML이 자리 잡았는지 바로 보입니다. 중괄호와 따옴표가 사라지고 주석을 달 수 있습니다.

# 웹 서비스 설정
service:
  name: web-api
  port: 8080
  replicas: 3
  env:
    - DB_HOST=db.internal
    - LOG_LEVEL=info
  healthcheck:
    path: /health
    interval: 30

{
  "service": {
    "name": "web-api",
    "port": 8080,
    "replicas": 3,
    "env": ["DB_HOST=db.internal", "LOG_LEVEL=info"],
    "healthcheck": { "path": "/health", "interval": 30 }
  }
}

⚠️ YAML에서 실수하기 쉬운 지점

YAML은 읽기 쉬운 대신 눈에 안 보이는 규칙이 많습니다. 배포가 실패하는 원인의 상당수가 여기서 나옵니다.

• 탭 문자 금지 — 들여쓰기에 탭을 쓰면 파싱 자체가 실패합니다. 에디터에서 탭을 스페이스로 변환하도록 설정해두세요.
• 불린으로 둔갑하는 값들 — yes, no, on, off가 true/false로 해석되는 경우가 있습니다. GitHub Actions에서 on: 키가 헷갈리는 이유이기도 합니다.
• 앞자리 0이 있는 숫자 — 우편번호나 버전 번호처럼 0123 형태는 8진수로 해석될 수 있습니다. 따옴표로 감싸세요.
• 콜론 뒤 공백 필수 — key:value는 통째로 문자열이 됩니다. 반드시 key: value로 쓰세요.
• 값 안의 콜론 — url: http://a.com처럼 값에 콜론이 들어가면 따옴표로 감싸는 편이 안전합니다.
• 주석은 변환 시 사라짐 — JSON은 주석을 지원하지 않으므로 YAML → JSON 변환에서 # 주석이 모두 제거됩니다.

💡 활용 사례

• Docker Compose YAML을 JSON으로 변환하여 프로그램에서 파싱
• Kubernetes 매니페스트를 JSON으로 변환하여 API 전송
• JSON API 응답을 YAML로 변환하여 가독성 있게 확인
• GitHub Actions 워크플로우 디버깅

자주 묻는 질문