YAML 검사기 및 포맷터

YAML을 붙여넣어 구문을 검사하고, 오류 위치를 찾고, 일관된 서식의 깔끔한 출력을 받으세요.

출력 옵션

YAML입력

비어 있음

YAML출력

YAML 출력이 여기에 표시됩니다

전부 브라우저에서 실행되며 아무것도 업로드되지 않습니다. 스팸과 봇을 막기 위해 공정 사용 제한(입력당 5 MB, 변환 횟수 제한)이 적용됩니다.

URL에서 불러오기

파일은 브라우저가 직접 가져오므로 서버가 교차 출처 요청을 허용해야 합니다.

키보드 단축키

Ctrl / ⌘ + Enter 지금 변환
Ctrl / ⌘ + S 출력 다운로드
Alt + Shift + C 출력 복사
Alt + Shift + F JSON 입력 수정 및 정렬
Alt + Shift + S 방향 전환
Alt + Shift + T 코드, 트리, 맵 보기 전환
Ctrl / ⌘ + Z 실행 취소 (정렬, 수정, 지우기 포함)
Esc 전체 화면 종료
편집기 글자 크기

지저분한 YAML 정리

섞인 들여쓰기, 인라인 맵, 불필요한 따옴표는 모두 문제없이 파싱되지만 검토하기는 어렵습니다. 포맷팅된 출력은 모든 파일을 같은 모양으로 만듭니다.

입력
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
포맷팅 결과
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

흔한 YAML 오류와 해결 방법

이 검사기는 물론 kubectl, Helm, docker compose 같은 도구에서도 가장 자주 보게 되는 메시지입니다.

오류 메시지의미와 해결 방법
tab characters must not be used in indentation YAML은 들여쓰기에 공백만 허용합니다. 탭을 모두 공백으로 바꾸세요.
bad indentation of a mapping entry 키가 형제 키와 다르게 들여쓰기되었거나, 일반 값에 ": "가 들어 있습니다. 키를 이웃 키와 맞추거나 값을 따옴표로 감싸세요.
mapping values are not allowed in this context kubectl과 Helm이 보고하는 같은 문제입니다. 보통 URL이나 시간처럼 ": "가 포함된 따옴표 없는 값 때문입니다. 값을 따옴표로 감싸세요.
end of the stream or a document separator is expected 목록 항목이나 키가 잘못된 들여쓰기 수준에 있습니다. 예를 들어 목록 뒤에 같은 수준의 매핑이 오는 경우입니다.
unexpected end of the stream within a flow collection 인라인 목록 [ … ]이나 맵 { … }이 닫히지 않았습니다. 빠진 괄호를 추가하세요.
duplicated mapping key 같은 키가 한 매핑에 두 번 나옵니다. 둘 중 하나를 제거하거나 이름을 바꾸세요.
unidentified alias *defaults 같은 별칭이 앵커 &defaults보다 먼저, 또는 앵커 없이 사용되었습니다.

검사기가 확인하는 항목

버튼으로 일부러 파일을 망가뜨리고 어떤 검사가 잡아내는지 확인해 보세요.

구문과 들여쓰기

탭, 어긋난 키, 닫히지 않은 따옴표와 괄호를 정확한 줄과 열과 함께 보고합니다.

중복 키

같은 매핑에서 두 번 정의된 키는 오류입니다. 일부 파서는 조용히 마지막 값을 유지합니다.

앵커와 별칭

모든 별칭은 문서 앞부분에서 정의된 앵커를 가리켜야 하며, 병합 키는 매핑을 참조해야 합니다.

여러 문서

---로 구분된 파일의 각 문서를 파싱하며, 메모에 발견된 문서 수가 표시됩니다.

기본적으로 비공개

검사는 브라우저에서 실행되므로 CI 파일과 매니페스트의 비밀 정보가 내 컴퓨터를 벗어나지 않습니다.

JSON이 필요하신가요?

유효한 YAML은 YAML JSON 변환기에서 클릭 한 번으로 JSON으로 변환됩니다.

더 많은 도구

JSON과 YAML이 만나는 모든 곳을 위한 변환기, 검사기, 단계별 가이드.

자주 묻는 질문

온라인에서 YAML을 어떻게 검사하나요?

YAML을 붙여넣거나 .yaml 또는 .yml 파일을 끌어다 놓으세요. 입력하는 동안 배지에 '유효한 YAML' 또는 '잘못된 YAML'이 표시됩니다. 잘못된 파일이면 정확한 줄과 열이 담긴 오류 메시지가 나타나고 편집기에서 해당 줄이 강조 표시됩니다.

포맷팅된 출력은 무엇을 하나요?

같은 데이터를 일관된 들여쓰기와 따옴표로 다시 작성합니다. 블록 스타일, 선택한 들여쓰기, 꼭 필요한 곳에만 따옴표를 사용합니다. 커밋하기 전에 파일을 정리하는 빠른 방법입니다.

포맷팅된 출력에 주석이 유지되나요?

아니요. 검사기는 YAML을 데이터로 파싱한 뒤 다시 작성하는데, 주석은 데이터에 포함되지 않습니다. 출력은 구조 확인에 사용하고, 주석이 중요하다면 원본 파일을 보관하세요.

다중 문서 YAML 파일을 검사할 수 있나요?

네. ---로 구분된 문서를 각각 검사하며, 포맷팅된 출력에서도 개별 문서로 유지됩니다. 편집기 아래 메모에 발견된 문서 수가 표시됩니다.

Kubernetes나 Docker Compose 스키마도 검사하나요?

특정 스키마가 아니라 YAML 구문을 검사합니다. 유효한 YAML이라도 알 수 없는 필드가 있으면 kubectl이나 docker compose가 거부할 수 있습니다. 스키마 검사에는 kubectl apply --dry-run=server나 docker compose config를 사용하세요.

어떤 YAML 버전을 사용하나요?

파싱은 YAML 1.2 core 스키마를 따르므로 yes, no, on, off는 문자열로 유지됩니다. 'YAML 1.1 호환'을 켜면 출력에서 이 단어들에 따옴표를 붙이므로 PyYAML 같은 오래된 파서도 문자열로 읽습니다.