YAML 포맷터 및 검사기

기능

YAML은 읽기 쉬워서 설정 파일에 널리 쓰입니다. Kubernetes 매니페스트, GitHub Actions와 GitLab CI 워크플로, Docker Compose, Ansible 플레이북, OpenAPI 문서 등이 그렇습니다. 하지만 쉽게 깨지기도 합니다. 들여쓰기 한 칸 차이, 탭 문자, 닫히지 않은 따옴표, 콜론 뒤에 빠진 공백 하나로 파일의 의미가 바뀌거나 아예 읽히지 않을 수 있습니다.

이 검사기는 YAML을 해석해 모든 문법 오류를 줄과 열 번호와 함께 알려 주고, 알 수 없는 지시어 같은 경고도 보여 줍니다. YAML이 올바르면 문서 수와 각 문서 루트 값의 종류를 표시하고, 들여쓰기를 통일해 깔끔하게 정리한 결과도 출력할 수 있습니다.

사용 방법

1. 입력란에 YAML을 붙여 넣거나 .yaml, .yml 파일을 업로드하거나 예제를 누릅니다.
2. 입력하는 대로 결과가 나타납니다. 초록색 올바른 YAML 배지 또는 3행 2열 같은 오류 목록입니다.
3. 정리된 YAML 표시를 켜 두면 깔끔한 사본을 얻을 수 있고, 들여쓰기를 2칸 또는 4칸으로 고를 수 있습니다. 블록 위의 버튼으로 복사하세요.
4. 도구가 반복 키를 허용하는 경우에만 중복 키를 오류로 처리를 끄세요.

흔한 실수

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• 들여쓰기 불일치: 같은 수준의 항목은 같은 열에서 시작해야 합니다. YAML은 탭 들여쓰기를 허용하지 않습니다.
• 콜론 뒤 공백 누락: key:value는 키와 값이 아니라 일반 문자열입니다.
• 특수 문자에 따옴표 누락: *, &, !, %, @, 백틱으로 시작하거나 : , #를 포함하는 값은 따옴표가 필요합니다.
• 예상과 다른 타입: yes, no, on, off는 YAML 1.2에서는 문자열이지만 예전 YAML 1.1 파서에서는 불리언입니다. 안전하게 따옴표로 감싸세요. 1.10 같은 버전 번호도 따옴표가 없으면 숫자 1.1이 됩니다.

구조 검사

이 도구는 문법, 즉 텍스트가 올바른 형식의 YAML인지를 검사합니다. 파일에 올바른 키와 값 타입이 있는지 확인하려면 YAML → JSON 변환 도구로 바꾼 뒤 그 결과를 JSON Schema 검사기로 검사하세요.