YAML 검사기
YAML 문법을 브라우저에서 검사합니다. 첫 번째 오류의 줄과 열, 쉬운 원인 설명과 함께 문서 수, 키 수, 중첩 깊이를 보여 줍니다.
공백 하나가 잘못 놓이면 쿠버네티스 매니페스트, GitHub Actions 워크플로, Docker Compose 파일이 깨질 수 있고, 파일을 읽는 도구의 오류 메시지는 이해하기 어려울 때가 많습니다. 여기에 YAML을 붙여 넣으면 파싱이 되는지 확인하고, 안 된다면 정확한 줄과 열, 주변 줄, 쉬운 말로 된 설명을 보여 줍니다. 올바른 파일은 문서 수, 키 수, 목록 항목 수, 중첩 깊이를 요약해 줍니다.
사용 방법
- 상자에 YAML을 붙여 넣습니다. 입력하는 동안 바로 검사됩니다.
- 올바르지 않으면 위치와 설명을 읽고, 주변 줄(^가 가리키는 곳)을 확인합니다.
- 첫 번째 오류를 고치고 다시 검사합니다. 뒤쪽 오류는 첫 번째 오류가 사라져야 나타납니다.
- 필요하면 정규화된 YAML이나 JSON을 열어 데이터가 실제로 어떻게 읽히는지 확인합니다.
계산식
올바름 = 텍스트가 하나 이상의 YAML 문서로 파싱됨 (js-yaml loadAll)
검사 대상은 들여쓰기, 따옴표, 괄호, 앵커와 별칭, 태그, 중복 키 같은 문법입니다. 쿠버네티스 필드 이름의 철자 같은 스키마는 파일을 읽는 프로그램에 달려 있으므로 검사하지 않습니다.
예시
예제 Deployment에서 containers는 name, image, ports 키를 가진 항목 하나짜리 목록입니다. image:를 공백 한 칸 더 들여쓰면 파서가 그 줄에서 bad indentation of a mapping entry로 멈춥니다. 위의 name:과 열이 맞지 않기 때문입니다. 같은 열로 되돌리면 결과가 올바른 YAML(문서 1개, 키 15개, 목록 항목 2개, 중첩 깊이 8)로 돌아옵니다.
자주 묻는 질문
YAML에서 탭을 쓸 수 있나요?
들여쓰기에는 쓸 수 없습니다. 명세가 금지합니다. 탭은 값과 주석 안에서는 허용됩니다. 편집기에서 .yml 파일에 공백이 입력되도록 설정하세요.
중복된 키가 왜 오류인가요?
YAML은 매핑의 키가 고유하도록 요구합니다. 일부 파서는 마지막 값을 조용히 남겨 실제 실수를 가리므로, 이 검사기는 이를 오류로 알려 줍니다.
스키마에 맞는지도 검사하나요?
아닙니다. 파일이 올바른 형식의 YAML인지만 확인합니다. 쿠버네티스, Ansible, GitHub Actions에 맞는 필드인지는 각 도구가 따로 검사합니다.
내 파일이 업로드되나요?
아닙니다. 파싱은 브라우저에서 이뤄지므로 설정 파일 속 비밀 값이 기기 밖으로 나가지 않습니다.
출처
최종 업데이트:
이 입력값이 담긴 페이지 주소: https://kakao.mobile/ko/tools/yaml-validator/
인용·퍼가기
kakaoCalc. (2026, November 8). YAML 검사기. https://kakao.mobile/ko/tools/yaml-validator/
“YAML 검사기.” kakaoCalc, 8 Nov. 2026, kakao.mobile/ko/tools/yaml-validator/.