.yaml · application/yaml
YAML: YAML 설정 및 직렬화 형식
YAML 1.2는 들여쓰기 기반의 데이터 직렬화 언어로, # 주석, 앵커 참조, 여러 줄 문자열 및 --- 구분자를 통한 다중 문서를 지원합니다.
빠른 답변: YAML 1.2는 들여쓰기 기반의 데이터 직렬화 언어로, # 주석, 앵커 참조, 여러 줄 문자열 및 --- 구분자를 통한 다중 문서를 지원합니다. Kubernetes 매니페스트, GitHub Actions 워크플로, Docker Compose 및 사람이 직접 편집하는 설정 파일.
| 구조 유형 | 계층형 |
|---|---|
| 사람 가독성 | 높음 |
| 중첩 지원 | 지원 |
| LLM 토큰 효율 | 보통 |
| 파일 확장자 | .yaml |
| MIME 유형 | application/yaml |
| 추천 용도 | Kubernetes 매니페스트, GitHub Actions 워크플로, Docker Compose 및 사람이 직접 편집하는 설정 파일. |
장점
- 중괄호 없이 깔끔한 여러 줄 블록과 인라인 # 주석 작성을 기본 지원
- --- 구분자를 사용해 단일 파일 안에 여러 설정 문서를 담을 수 있음
- JSON의 상위 호환(superset)으로 운영 매니페스트 가독성이 뛰어남
단점 및 주의사항
- 공백 들여쓰기가 한 칸만 어긋나도 전체 구조가 조용히 망가질 수 있음
- YAML 1.1에서는 따옴표 없는 NO나 ON 문자열이 불리언으로 오인될 수 있음
- 앵커·별칭 등 규격이 복잡해 파서 구현 및 검증 난이도가 높음
참고 자료
YAML 로컬 변환 및 정리 도구
관련 엔지니어링 가이드
- JSON vs YAML vs TOML vs .env: 설정 파일 형식 실무 비교 가이드JSON, YAML, TOML, .env 설정 파일 형식을 주석, 중첩, 시크릿 보안 및 생태계 기준으로 비교하고 브라우저에서 안전하게 로컬 변환합니다.
- 서버 전송형 웹 붙여넣기 도구가 위험한 이유 — 무전송(Zero-Upload) 아키텍처.env 시크릿, JWT, 고객 CSV, 계약서를 클라우드 변환기에 붙여넣을 때 생기는 유출 위험과 브라우저 Network 탭에서 0바이트 전송을 검증하는 법을 알아봅니다.
- AI 분석 전 CSV 및 JSON 고객 데이터를 로컬에서 마스킹하는 방법브라우저 RAM에서 민감한 CSV 열을 익명화하고 매출 금액을 비례 스케일링(×k)하며 중첩 JSON 키를 구문 손상 없이 마스킹합니다.
- XML → JSON 변환: 속성, CDATA 및 RSS 피드 보존 실전 가이드브라우저 RAM에서 XML, RSS, SVG를 JSON으로 변환하며 @_ 속성, CDATA 블록, 숫자 타입을 유지하고 XML 왕복 변환까지 처리합니다.
관련 형식
24개 형식 전체 보기YAML 자주 묻는 질문
YAML의 '노르웨이 문제(Norway problem)'란 무엇인가요?
YAML 1.1에서 따옴표 없는 국가 코드 NO나 yes/on/off 값이 문자열이 아닌 불리언(false/true)으로 파싱되는 현상입니다. JSON으로 변환해 확인하면 안전합니다.
하나의 YAML 파일에 여러 문서를 포함할 수 있나요?
네. Kubernetes 매니페스트는 --- 줄로 리소스를 구분하는 경우가 많으며, YAML to JSON은 다중 문서 로드를 통해 JSON 배열로 변환합니다.
.yml 확장자와 .yaml 확장자 사이에 문법 차이가 있나요?
아니요. 두 확장자 모두 동일한 YAML 문법을 담고 있습니다. 공식 권장 확장자는 .yaml이며 Docker·CI 환경에서는 .yml도 흔히 쓰입니다.