YAML 포매터
매핑, 시퀀스, 스칼라 값, 인용부호와 주석을 유지하면서 YAML에 일관된 들여쓰기를 적용합니다.
Make YAML structure easier to read
들여쓰기가 고르지 않은 YAML은 부모와 자식 관계, 목록 항목, 스칼라 값을 숨길 수 있습니다. 이 도구는 설정 구조를 읽기 쉬운 줄과 들여쓰기로 보여 줍니다.
서식 변경은 YAML이 스키마나 애플리케이션 계약을 따른다는 증명이 아닙니다. 키, 값, 순서, 인용부호, 주석과 명시적 타입을 원본과 비교하세요.
작은 샘플로 시작하고 원본, 서식 결과, parser와 schema 결과를 분리해 보관하세요.
운영 설정을 다룰 때는 diff를 검토하세요. 읽기 쉬운 파일에도 위험한 값이나 예상하지 못한 타입, alias가 있을 수 있습니다.
Formatting is not YAML validation
YAML은 들여쓰기와 구두점을 사용해 매핑, 시퀀스, 스칼라, 주석, anchor, alias와 문서 경계를 표현합니다.
Formatter는 구조와 공백을 정리하지만 JSON Schema, OpenAPI, Kubernetes, CI 규칙을 검증하지 않습니다.
일반 문자열, 인용 문자열, boolean, null, 숫자와 여러 줄 블록은 parser 버전에 따라 다르게 해석될 수 있습니다.
주석은 독자에게 유용하지만 보통 애플리케이션 데이터는 아닙니다. downstream serializer가 주석을 보존하는지 확인하세요.
How to format YAML
- 완전한 YAML 문서나 문서화된 조각을 입력합니다.
- 매핑, 목록 표시, 들여쓰기, 인용부호, 주석과 블록을 확인합니다.
- 키, 값, 순서, anchor, alias와 문서 표시가 의도한 의미인지 원본과 비교합니다.
- 프로젝트에 필요한 parser, schema validator, linter와 애플리케이션 테스트를 실행합니다.
- 운영 샘플에서는 비밀과 개인정보를 제거하고 원본을 보관합니다.
Formatting method
- 입력 YAML에서 매핑,
입력 YAML에서 매핑, 시퀀스, 스칼라 스타일, 주석과 문서 경계를 읽습니다.
- 부모 키와 자식
부모 키와 자식 값이 보이도록 줄바꿈과 들여쓰기를 적용합니다.
- 인용 문자열, boolean,
인용 문자열, boolean, 숫자, anchor, alias, 블록과 주석을 원본에 맞게 유지합니다.
정확한 parser 버전, 스칼라 변환, 주석 보존, alias 처리와 오류 문구는 실제 엔진에서 확인해야 합니다.
Read the formatted result
성공 결과는 입력 YAML의 읽기 쉬운 배치입니다. 트리, 값, 순서, 주석과 스칼라 스타일이 원본과 같은지 확인하세요.
실패가 특정 parser 규칙을 증명하는 것은 아닙니다. 오류 위치는 실제 runtime 증거로 확인하세요.
schema나 애플리케이션 검사 실패는 별도의 계약 문제입니다. 서식은 필수 키를 추가하거나 타입 안전성을 보장하지 않습니다.
흔한 실수
들여쓰기를 schema 검증으로 오해하면 누락된 키나 잘못된 타입을 놓칠 수 있습니다.
날짜, 콜론, boolean, 앞자리 0이 있는 값을 인용부호 없이 바꾸면 해석이 달라질 수 있습니다.
목록이나 매핑을 보기 좋게 정렬하면 순서에 민감한 설정이 바뀔 수 있습니다.
anchor와 alias 또는 부모 들여쓰기 없이 조각만 시험하면 운영 파일과 달라집니다.
제한 사항 및 특수 사례
이 기능은 YAML 서식 정렬이며 schema, linter, 비밀 관리, 변환 정확성이나 애플리케이션 호환성을 보장하지 않습니다.
스칼라 변환, 중복 키, anchor, alias, 여러 줄 블록과 YAML 버전은 대상 parser에서 시험하세요.
정책이 허용하지 않으면 기밀 운영 설정을 붙여 넣지 마세요.
Examples
서식 정렬이 YAML schema를 검증하나요?
서식 정렬이 YAML schema를 검증하나요?
완전한 YAML 문서나 문서화된 조각을 입력합니다.
성공 결과는 입력 YAML의 읽기 쉬운 배치입니다. 트리, 값, 순서, 주석과 스칼라 스타일이 원본과 같은지 확인하세요.
스칼라 타입이 바뀌나요?
스칼라 타입이 바뀌나요?
매핑, 목록 표시, 들여쓰기, 인용부호, 주석과 블록을 확인합니다.
실패가 특정 parser 규칙을 증명하는 것은 아닙니다. 오류 위치는 실제 runtime 증거로 확인하세요.
주석이 보존되나요?
주석이 보존되나요?
키, 값, 순서, anchor, alias와 문서 표시가 의도한 의미인지 원본과 비교합니다.
schema나 애플리케이션 검사 실패는 별도의 계약 문제입니다. 서식은 필수 키를 추가하거나 타입 안전성을 보장하지 않습니다.
YAML 조각도 정렬할 수 있나요?
YAML 조각도 정렬할 수 있나요?
프로젝트에 필요한 parser, schema validator, linter와 애플리케이션 테스트를 실행합니다.
성공 결과는 입력 YAML의 읽기 쉬운 배치입니다. 트리, 값, 순서, 주석과 스칼라 스타일이 원본과 같은지 확인하세요.
들여쓰기가 YAML 크기를 줄이나요?
들여쓰기가 YAML 크기를 줄이나요?
운영 샘플에서는 비밀과 개인정보를 제거하고 원본을 보관합니다.
실패가 특정 parser 규칙을 증명하는 것은 아닙니다. 오류 위치는 실제 runtime 증거로 확인하세요.
인용된 boolean과 숫자는 어떻게 하나요?
인용된 boolean과 숫자는 어떻게 하나요?
완전한 YAML 문서나 문서화된 조각을 입력합니다.
schema나 애플리케이션 검사 실패는 별도의 계약 문제입니다. 서식은 필수 키를 추가하거나 타입 안전성을 보장하지 않습니다.
Frequently asked questions
서식 정렬이 YAML schema를 검증하나요?
아니요. YAML을 배치할 뿐입니다. 프로젝트의 JSON Schema, OpenAPI, Kubernetes 또는 애플리케이션 validator를 사용하세요.
스칼라 타입이 바뀌나요?
표시 공백을 추가하면서 표현을 유지해야 하지만 parser와 serializer에 따라 다를 수 있습니다. 타입이 중요하면 parse 결과를 비교하세요.
주석이 보존되나요?
예제는 주석을 formatted view에 유지합니다. pipeline에서 의존하기 전에 실제 엔진에서 확인하세요.
YAML 조각도 정렬할 수 있나요?
완전한 문서나 문서화된 조각을 사용하세요. 조각은 anchor나 부모 들여쓰기에 의존할 수 있습니다.
들여쓰기가 YAML 크기를 줄이나요?
아니요. 읽기 위한 공백은 보통 크기를 늘립니다. 소비자가 지원할 때만 별도 minify 과정을 사용하세요.
인용된 boolean과 숫자는 어떻게 하나요?
문자열을 뜻하는 값에는 인용부호를 유지하세요. 대상 YAML 버전과 schema로 해석을 확인하세요.
잘못된 YAML을 자동으로 고치나요?
자동 수정을 가정하지 마세요. 들여쓰기나 문법을 고치고 프로젝트의 parser와 검사로 확인하세요.
서식 후 무엇을 해야 하나요?
diff를 검토하고 parser, schema 검사를 실행하며 alias나 공백이 중요하면 실제 consumer로 시험하세요.