개발자 도구

YAML 포맷터

YAML을 붙여 넣으면 깔끔하게 정리해 주거나, 어느 줄이 잘못되었는지 정확히 알려 줍니다.

YAML 포맷터 내 기기에서 실행

작동 방식

YAML의 설계는 전적으로 들여쓰기에 기대고 있어서 읽기는 편하지만 유난히 깨지기 쉽습니다. 공백 하나가 잘못되면 20분 뒤 CI 파이프라인에서 오류 메시지가 나옵니다. 이 도구는 여기서 바로 분석해 즉시 알려 줍니다.

문서가 분석되지 않으면 실패한 줄과 열, 그리고 파서가 밝힌 이유를 알려 줍니다. 이쪽이 포맷된 출력보다 훨씬 유용한 경우가 대부분이며, 많은 사람이 이런 도구를 여는 이유이기도 합니다.

유효한 YAML은 데이터 구조로 분석된 뒤 처음부터 다시 쓰이므로, 들여쓰기가 균일해지고 따옴표가 정규화되며 불필요한 끝 공백이 사라집니다. 텍스트를 편집하는 것이 아니라 데이터를 거쳐 왕복하기 때문에 결과가 유효한 YAML임이 보장됩니다.

주석은 사라집니다. 주석은 데이터에 포함되지 않으므로 파서가 버립니다. 앵커와 별칭은 보존되지 않고 전체 값으로 펼쳐집니다. 파일의 주석이 중요하다면 사본을 포맷한 뒤 들여쓰기 수정은 직접 적용하세요.

알파벳순 정렬은 diff에서 두 설정 파일을 실제로 비교할 수 있게 해 줍니다. 하지만 순서가 읽는 사람에게 의미를 갖는 파일에는 잘못된 선택입니다. CI 파이프라인은 알파벳순보다 실행 순서일 때 읽기 쉽습니다.

---로 구분된 여러 문서가 들어 있는 파일도 처리하며, 각 문서를 차례로 포맷합니다.

자주 묻는 질문

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

포맷은 YAML을 데이터로 분석해 다시 쓰는 방식이며, 주석은 데이터에 포함되지 않습니다. 주석을 보존해야 한다면 사본을 포맷하세요.

오류가 어디인지 알려 주나요?

네, 줄과 열 위치 그리고 파서의 설명을 함께 보여 줍니다.

YAML이 업로드되나요?

아니요. 브라우저에서 분석합니다. YAML에 비밀 정보와 인프라 세부 정보가 얼마나 자주 들어 있는지를 생각하면 중요한 부분입니다.

한 파일에 문서가 여러 개 있어도 처리하나요?

네, ---로 구분된 문서를 각각 포맷합니다.

키를 정렬해야 하나요?

설정 파일 두 개를 비교할 때 유용합니다. 순서가 읽는 사람에게 의미가 있는 경우에는 도움이 되지 않습니다.