KO
내 도구

YAML 정리기(포맷터)

YAML을 일정한 스타일로 정리합니다. 공백 2/4칸 들여쓰기, 키 정렬, 따옴표 방식, 줄 너비, 블록·플로 스타일, 앵커 펼치기, 여러 문서를 지원합니다.

해제하면 "key:" 뒤의 "- item"이 같은 들여쓰기에 놓입니다(쿠버네티스와 Ansible 문서에서 자주 쓰는 스타일).
내 도구 →
광고

여러 사람이 고친 YAML은 들여쓰기가 뒤섞이고, 어떤 곳은 인라인 {…}와 […], 어떤 곳은 블록이며 따옴표도 제각각입니다. 이 정리기는 YAML을 읽어 하나의 일정한 스타일로 다시 씁니다. 공백 2칸 또는 4칸, 블록 또는 플로 컬렉션, 원하는 따옴표, 선택적인 키 정렬과 줄바꿈이 가능합니다. 여러 문서(---)가 있는 파일도 처리하고, !Ref, !Sub, !vault 같은 CloudFormation·Ansible 태그를 유지하며, 오류는 줄과 열 번호로 알려 줍니다.

사용 방법

  1. YAML을 붙여 넣습니다. 쿠버네티스 매니페스트, Docker Compose 파일, GitHub Actions 워크플로, CloudFormation 템플릿 등입니다.
  2. 공백 2칸 또는 4칸, 목록 항목을 키 아래에 들여쓸지 고릅니다.
  3. 블록 또는 플로 스타일, 따옴표 문자, 줄바꿈 너비를 고릅니다.
  4. 필요하면 키를 정렬하거나 앵커를 펼칩니다.
  5. 정리된 YAML을 복사합니다. 주석은 제거되므로 필요한 주석은 따로 챙겨 두세요.

계산식

파싱(YAML 1.2 코어 스키마) → 데이터 → 하나의 들여쓰기, 스타일, 따옴표로 쓰기

YAML을 파싱해 다시 쓰므로 결과는 같은 데이터를 일정한 스타일로 표현한 것입니다. 문자열은 그대로 두면 다른 것(숫자, 불리언, null, YAML 문법)으로 읽힐 때만 따옴표로 감싸며, "모든 문자열에 따옴표 붙이기"를 선택하면 모두 감쌉니다. 병합 키(<<)는 적용하지 않고 유지합니다. 주석과(정렬 시) 원래 키 순서는 보존되지 않습니다.

예시

예제 Docker Compose 파일은 공백 4칸과 10칸 들여쓰기와 인라인 매핑이 섞여 있습니다. 공백 2칸으로 정리하면 일정한 블록이 됩니다. services: → web:에 image: nginx:1.27, '80:80'과 '443:443'이 든 ports: 목록(YAML 1.1 파서는 80:80을 숫자로 읽으므로 따옴표 처리), restart: always가 오고, 이어서 환경 변수가 중첩 매핑이고 볼륨이 목록인 db:, 마지막으로 db-data: {}가 있는 volumes:가 옵니다.

자주 묻는 질문

주석이 사라진 이유는 무엇인가요?

정리기는 YAML을 데이터로 파싱해 다시 쓰며, 주석은 데이터에 포함되지 않습니다. 주석이 있는 파일은 사본을 보관하거나, 정리한 뒤 중요한 주석을 다시 넣으세요.

일부 값에 따옴표가 붙은 이유는 무엇인가요?

따옴표가 없으면 다른 뜻이 되기 때문입니다. 80:80과 1e3은 숫자처럼 보이고, yes/no/on/off는 YAML 1.1 도구에서 불리언이며, * & ! { [ #로 시작하는 값은 문법입니다. 따옴표를 붙이면 어떤 파서에서도 문자열로 유지됩니다.

쿠버네티스나 GitHub Actions 파일에도 안전한가요?

네. 데이터는 그대로이고 배치만 바뀝니다. 특히 주석이나 특정 키 순서에 의존한다면 커밋하기 전에 결과를 확인하세요.

내 YAML이 업로드되나요?

아닙니다. 정리는 브라우저에서 이뤄집니다.

출처

최종 업데이트:

인용·퍼가기
APA

kakaoCalc. (2026, November 8). YAML 정리기(포맷터). https://kakao.mobile/ko/tools/yaml-formatter/

MLA

“YAML 정리기(포맷터).” kakaoCalc, 8 Nov. 2026, kakao.mobile/ko/tools/yaml-formatter/.

광고