YAML 포매터 및 유효성 검사기
YAML을 온라인에서 포맷, 검증, 정리하세요. 행 번호와 함께 구문 오류를 즉시 강조 표시합니다. 무료이며 브라우저에서 완전히 실행됩니다.
사용 방법
- 입력 영역에 YAML을 붙여넣습니다
- 「포맷 및 검증」을 클릭하여 정리하고 구문을 확인합니다
- YAML이 유효하지 않으면 오류 메시지에 정확한 줄 번호와 문제가 표시됩니다
- 들여쓰기 선택기를 조정하여 출력 들여쓰기를 제어합니다
- 「복사」를 클릭하여 포맷된 결과를 복사하거나 「지우기」를 클릭하여 초기화합니다
자주 묻는 질문
-
YAML 유효성 검사란 무엇인가요?
YAML 유효성 검사는 문서가 올바른 YAML 구문(적절한 들여쓰기, 중복 키 없음, 유효한 데이터 타입, 특수 문자의 올바른 사용)을 따르는지 확인합니다.
-
포맷하면 데이터가 변경되나요?
아니요. 포맷은 공백과 들여쓰기만 변경합니다. 데이터 구조와 값은 완전히 동일하게 유지됩니다.
-
흔한 YAML 구문 오류는 무엇인가요?
흔한 오류로는 들여쓰기 불일치(탭과 스페이스 혼용), 키 뒤 콜론 누락, : 나 # 같은 특수 문자를 포함한 따옴표 없는 문자열, 중복 키 등이 있습니다.
-
입력한 YAML이 서버로 전송되나요?
아니요. 모든 포맷 및 유효성 검사는 js-yaml 라이브러리를 사용하여 브라우저에서 완전히 처리됩니다. 데이터는 절대 기기를 벗어나지 않습니다.
-
YAML과 JSON의 차이는 무엇인가요?
YAML은 JSON의 상위 집합으로 주석, 여러 줄 문자열을 지원하며 덜 장황합니다. JSON은 중괄호와 따옴표를 사용하는 반면 YAML은 들여쓰기를 사용합니다. YAML은 설정 파일에, JSON은 API에 주로 사용됩니다.
YAML 이란
**YAML(YAML Ain't Markup Language)**은 사람이 읽고 쓰기 쉬운 데이터 직렬화 언어입니다. 2001년에 처음 등장했으며, XML의 복잡함과 JSON의 제한을 극복하기 위해 설계되었습니다. YAML은 파이썬 스타일의 들여쓰기를 사용하여 데이터 구조를 표현하며, 주석을 지원하고 문법이 간결하다는 것이 주요 특징입니다.
YAML 핵심 문법
YAML의 기본 문법 요소는 다음과 같습니다.
키-값 쌍: 콜론과 공백으로 구분합니다.
name: 홍길동
age: 30
active: true
리스트: 하이픈(-)으로 항목을 표시합니다.
languages:
- Korean
- English
- Japanese
중첩 객체: 들여쓰기로 계층을 표현합니다.
database:
host: localhost
port: 5432
name: mydb
여러 줄 문자열: |(블록 스칼라)와 >(폴드 스칼라) 두 가지 방식이 있습니다. |는 줄바꿈을 그대로 유지하고, >는 줄바꿈을 공백으로 변환합니다.
주석: # 문자로 시작하며 YAML의 큰 장점 중 하나입니다. JSON과 달리 주석으로 설정의 의도와 용도를 문서화할 수 있습니다.
JSON과의 비교
| 특성 | YAML | JSON |
|---|---|---|
| 주석 지원 | O | X |
| 문법 간결성 | 간결 | 장황 |
| 파싱 복잡도 | 높음 | 낮음 |
| 기계 처리 | 상대적으로 느림 | 빠름 |
| 주 용도 | 설정 파일 | API, 데이터 교환 |
자주 발생하는 YAML 문법 오류
YAML은 들여쓰기에 매우 민감하여 초보자가 자주 실수를 범합니다.
탭과 스페이스 혼용
YAML은 탭을 들여쓰기로 허용하지 않습니다. 반드시 스페이스만 사용해야 합니다. 텍스트 에디터에서 탭을 스페이스로 자동 변환하는 설정을 활성화하세요.
콜론 뒤 공백 누락
key:value는 오류입니다. 반드시 key: value처럼 콜론 뒤에 공백이 와야 합니다.
특수문자 포함 문자열의 따옴표 누락
콜론, 해시, 대괄호 등 특수문자가 포함된 값은 따옴표로 감싸야 합니다.
# 오류
message: Hello: World
# 올바름
message: "Hello: World"
불리언 자동 변환 주의
yes, no, on, off는 YAML 1.1에서 true/false로 자동 변환됩니다. 문자열로 사용하려면 따옴표로 감싸야 합니다.