개발자 유틸리티

YAML 검증기

YAML 코드를 붙여넣으면 문법 오류, 들여쓰기 문제, 콜론 누락, 배열 구조 문제를 확인하고 JSON 변환 결과까지 확인할 수 있습니다.

YAML 문법 검증 YAML 파서가 읽을 수 있는 문법인지 빠르게 확인합니다. 서비스별 설정 스키마는 별도 검사 대상입니다.
오류 위치 확인 파싱 오류 메시지를 통해 들여쓰기, 콜론, 따옴표 문제를 점검할 수 있습니다.
JSON 변환 지원 정상 YAML을 JSON 형태로 변환해 구조를 더 명확하게 확인할 수 있습니다.

YAML 입력

검증할 YAML 코드를 아래에 붙여넣으세요.

문법 검증 기준 입력한 YAML을 브라우저에서 파싱해 문법 오류를 확인합니다. Docker Compose·GitHub Actions·Kubernetes 규칙은 검증하지 않습니다.
구조 확인 검증이 성공하면 JSON 변환 결과를 함께 제공해 객체와 배열 구조를 확인할 수 있습니다.
0줄 0자 키 0개 검증 대기 중

검증 결과

YAML 문법 상태와 오류 메시지, JSON 변환 결과를 확인할 수 있습니다.

대기 중
YAML 코드를 입력한 뒤 검증하기 버튼을 눌러주세요.

YAML 사용 예시

YAML은 설정 파일에서 자주 사용되며, 들여쓰기와 구조가 중요합니다.

Docker Compose

services, volumes, networks처럼 계층 구조가 많은 설정 파일에서 YAML 문법이 자주 사용됩니다.

GitHub Actions

workflow, jobs, steps, uses, run 같은 자동화 설정을 YAML로 작성합니다.

Kubernetes

Deployment, Service, ConfigMap 같은 리소스 정의 파일에 YAML 형식이 널리 사용됩니다.

사용 가이드

YAML 문법 검증과 서비스별 설정 검증을 구분하는 법

YAML 파서가 문서를 읽을 수 있다는 사실은 Docker Compose, GitHub Actions나 Kubernetes가 그 설정을 받아들인다는 뜻이 아닙니다. 먼저 문법과 데이터 구조를 확인한 뒤 사용하는 서비스의 스키마와 명령으로 다시 검증해야 합니다.

이런 분께 유용합니다

  • YAML 들여쓰기와 문법 오류를 빠르게 찾는 개발자
  • CI/CD와 컨테이너 설정을 검토하는 운영자
  • YAML이 어떤 JSON 구조로 해석되는지 확인하려는 사용자

대표 활용 상황

  • 콜론·들여쓰기·따옴표 오류를 배포 전에 찾을 때
  • 배열과 객체가 의도한 구조로 파싱되는지 볼 때
  • 문법 검증 뒤 서비스별 공식 검증 명령을 실행하기 전 1차 점검할 때

처음부터 결과 확인까지

  1. 1

    비밀번호, API 키와 토큰을 제거하거나 마스킹한 YAML을 준비합니다.

  2. 2

    200,000자 이하의 코드를 입력하고 필요하면 JSON과 메타 정보 표시를 선택합니다.

  3. 3

    검증을 실행해 파서 오류의 라인과 컬럼을 확인합니다.

  4. 4

    성공한 경우 JSON 결과에서 문자열·숫자·불리언과 배열 구조가 의도와 같은지 확인합니다.

  5. 5

    앵커·별칭과 병합 키가 과도하거나 순환하지 않는지 검토합니다.

  6. 6

    Docker Compose config, GitHub Actions 편집기, kubectl dry-run 등 대상 서비스의 공식 검증을 추가로 실행합니다.

사용 예시 1

기본 매핑

입력
name: demo ports: - 8000
결과
name과 숫자 8000을 담은 ports 배열이 만들어집니다.

성공 표시뿐 아니라 변환된 자료형도 확인합니다.

사용 예시 2

문법은 맞지만 설정 키가 틀린 경우

입력
services: web: imag: nginx
결과
image 오타가 있어도 YAML 문법은 통과할 수 있습니다.

Compose 전용 설정 검증이 별도로 필요합니다.

계산·처리 기준

js-yaml 4.3.0을 사용하며 병합 키 총합을 10,000으로 제한합니다. 파싱한 객체·배열은 중복 방문을 피하며 노드 50,000개, 깊이 100까지 검사합니다. 입력 한도는 200,000자이며 JSON 변환은 선택할 수 있습니다.

알아둘 한계

  • 파서와 대상 서비스의 스키마에 따라 자료형 해석이 다를 수 있습니다.
  • 여러 문서가 섞인 YAML 스트림은 별도로 나누어 처리해야 합니다.
  • 순환 별칭은 유효한 YAML이어도 일반 JSON으로 바꿀 수 없습니다.
  • 문서 크기·노드 수·깊이 제한을 넘는 입력은 처리하지 않습니다.
개인정보 처리

입력 YAML은 브라우저에서 파싱하며 서버에 저장하지 않습니다. 파서 라이브러리는 외부 CDN에서 내려받으므로 네트워크 연결이 필요하지만 입력 내용은 CDN으로 전송하지 않습니다. 그래도 비밀값은 반드시 제거하세요.

함께 쓰면 좋은 도구

자주 묻는 질문

정상이면 Compose 설정도 맞나요?

아닙니다. Compose 설정은 docker compose config로 추가 확인해야 합니다.

유효한 YAML이 JSON으로 나오지 않는 이유는 무엇인가요?

순환 참조는 일반 JSON으로 직렬화할 수 없습니다.

오류 설명이 영어로 나오는 경우가 있나요?

파서가 제공하는 진단 문구는 원문을 유지하고 주변 안내는 선택한 언어로 표시합니다.