YAML 뷰어이란?
YAML 뷰어를 사용하면 YAML 파일을 붙여넣거나 업로드하여 즉시 서식이 지정된 구문 강조 트리 뷰로 확인할 수 있습니다. YAML 사양에 따라 유효성을 검사하고, 오류를 줄 번호와 함께 강조 표시하며, 중첩된 섹션을 접거나 펼쳐 대용량 설정 파일을 빠르게 탐색할 수 있습니다.
--- 로 구분된 멀티 도큐먼트 YAML을 지원하고, 중첩된 앵커를 보존하면서 입력값을 2칸 또는 4칸 중에서 선택한 들여쓰기로 다시 포맷합니다. 트리 뷰에서는 배열과 맵을 클릭 한 번으로 접을 수 있어 수백 줄짜리 Helm 차트나 Compose 파일도 구조가 한눈에 들어오고, 내장된 검색은 문서 전체에서 일치하는 키와 값을 강조해 줍니다. 오류는 정확한 줄과 칸 번호와 함께 표시되니 들여쓰기를 추측으로 고칠 필요가 없습니다.
사용 방법
- YAML 콘텐츠를 붙여넣거나 .yml/.yaml 파일을 편집기 영역에 드래그 앤 드롭하세요.
- 뷰어가 즉시 구문을 검증하고 오류가 있으면 줄 번호와 함께 강조 표시합니다.
- 트리 뷰와 원본 뷰 간에 전환하고, 중첩된 섹션을 접고, 서식이 적용된 결과를 다운로드하세요.
사용 시기
- kubectl apply 전에 Kubernetes 매니페스트를 검증해서 apiVersion이나 selector 오타를 잡을 때.
- 300줄짜리 docker-compose.yml을 통째로 스크롤하지 않고 한 번에 훑어보고 싶을 때.
- Ansible 플레이북이나 GitHub Actions 워크플로의 구조가 정상으로 파싱되는지 확인할 때.
결과
200줄이 넘는 Kubernetes 배포 매니페스트가 있습니다. 붙여넣기만 하면 필수 필드가 모두 있는지 빠르게 확인하고, 들여쓰기 오류를 발견하고, 다른 노드를 접어 컨테이너 스펙 섹션으로 바로 이동할 수 있습니다.
자주 묻는 질문
- 로컬에서 yamllint를 돌리는 것과 무엇이 다른가요?
- yamllint는 명령줄에서 줄 끝 공백, 라인 길이 같은 스타일 규칙을 강제합니다. 이 도구는 파싱과 시각화에 집중해서, 붙여넣으면 트리 형태로 구조를 보여 주고 들여쓰기를 통일한 결과물까지 다운로드할 수 있습니다.
- YAML의 앵커와 별칭(& 와 *)도 처리하나요?
- 처리합니다. js-yaml 파서가 앵커를 풀어 주기 때문에 트리 뷰에서 별칭이 사용된 곳에는 확장된 값이 그대로 보입니다. 재포맷된 출력은 앵커를 빼고 내용을 인라인으로 적어 주므로 diff 리뷰에 더 편합니다.
- 여러 YAML 문서를 한꺼번에 붙여 넣을 수 있나요?
- 있습니다. --- 로 구분된 문서들은 스트림으로 파싱되고, 도구막대에 문서 개수가 표시됩니다. 트리 뷰는 문서 사이에 구분선을 두고 세로로 쌓아 주기 때문에 같은 Kubernetes 매니페스트 안의 Deployment와 Service를 나란히 비교하기 편합니다.
- 오류의 줄 번호가 제 에디터와 안 맞는 이유는 무엇인가요?
- YAML 파서는 실제 내용이 처음 등장하는 줄을 1번으로 잡지만, 일부 에디터는 셔뱅이나 머리 주석을 다르게 세어 줍니다. 이럴 때는 칸 번호가 더 정확합니다. 파싱이 실패한 정확한 글자를 가리키기 때문입니다.
- 붙여 넣은 YAML이 서버로 전송되나요?
- 전송되지 않습니다. 파서와 포맷터 모두 기기 안에서 동작하므로, 실수로 비밀번호나 API 키가 섞여 있어도 외부로 나가지 않습니다. 다만 운영 환경 설정을 다룰 때는 항상 조심해서, 스크린샷을 공유하기 전에 민감한 값은 가려 주는 편이 안전합니다.