KO
내 도구

YAML 검사기

YAML 문법을 브라우저에서 검사합니다. 첫 번째 오류의 줄과 열, 쉬운 원인 설명과 함께 문서 수, 키 수, 중첩 깊이를 보여 줍니다.

같은 데이터를 일관된 스타일로 다시 쓴 결과입니다(주석은 유지되지 않습니다).
내 도구 →
광고

공백 하나가 잘못 놓이면 쿠버네티스 매니페스트, GitHub Actions 워크플로, Docker Compose 파일이 깨질 수 있고, 파일을 읽는 도구의 오류 메시지는 이해하기 어려울 때가 많습니다. 여기에 YAML을 붙여 넣으면 파싱이 되는지 확인하고, 안 된다면 정확한 줄과 열, 주변 줄, 쉬운 말로 된 설명을 보여 줍니다. 올바른 파일은 문서 수, 키 수, 목록 항목 수, 중첩 깊이를 요약해 줍니다.

사용 방법

  1. 상자에 YAML을 붙여 넣습니다. 입력하는 동안 바로 검사됩니다.
  2. 올바르지 않으면 위치와 설명을 읽고, 주변 줄(^가 가리키는 곳)을 확인합니다.
  3. 첫 번째 오류를 고치고 다시 검사합니다. 뒤쪽 오류는 첫 번째 오류가 사라져야 나타납니다.
  4. 필요하면 정규화된 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에 맞는 필드인지는 각 도구가 따로 검사합니다.

내 파일이 업로드되나요?

아닙니다. 파싱은 브라우저에서 이뤄지므로 설정 파일 속 비밀 값이 기기 밖으로 나가지 않습니다.

출처

최종 업데이트:

인용·퍼가기
APA

kakaoCalc. (2026, November 8). YAML 검사기. https://kakao.mobile/ko/tools/yaml-validator/

MLA

“YAML 검사기.” kakaoCalc, 8 Nov. 2026, kakao.mobile/ko/tools/yaml-validator/.

광고