데이터 형식

YAML(YAML Ain’t Markup Language)

YAML은 설정이나 데이터를 이름과 값, 목록 등의 구조로 적는 텍스트 형식입니다.

쉬운 설명

AI가 만든 배포 설정이나 문서 앞부분에서 콜론과 들여쓰기로 정리된 내용을 볼 수 있어요. YAML에서는 이런 구조로 이름에 해당하는 값이나 목록을 표현해요. 들여쓰기가 어떤 항목 안에 속하는지 결정할 수 있어서 공백도 의미가 있어요. YAML 문법이 맞는 것과 프로그램이 요구하는 설정 이름이 맞는 것은 따로 확인해야 해요.

이런 상황에서 만나요

스터디 사이트 설정에서 제목을 바꾸고 태그를 하나 추가하려고 한다고 해 볼게요. 아래는 문자열 하나와 두 항목의 목록을 적은 설명용 설정이에요.

이름·값·목록을 구분해서 읽어요

설명용 화면

1문자열 값

title: "AI 스터디"

2목록 값

tags:
  - AI
  - 입문

3읽은 결과

제목 AI 스터디

태그 AI, 입문

1title이라는 이름에 문자열 값을 지정해요.
2같은 깊이의 두 항목이 tags 목록에 들어가요.
3프로그램이 두 설정을 읽어 활용한다고 가정한 예시예요.

YAML 문법을 설명하는 가상의 설정입니다. 필드 이름과 쓰임은 실제로 이 파일을 읽는 프로그램의 규칙에 따라 달라집니다.

목록 항목은 같은 깊이로 맞춰요. 이 예시에서 tags 아래의 두 줄은 같은 목록에 들어가요. 파일을 고친 뒤에는 문법 검사뿐 아니라 사이트가 title과 tags라는 항목을 실제로 읽는지도 확인해요.

헷갈리기 쉬운 점

들여쓰기는 보기 좋게 맞추는 용도인가요?

블록 형식에서는 데이터 구조를 나타내요. 들여쓰기를 바꾸면 다른 항목 아래로 들어가거나 문법 오류가 날 수 있어요. 구조를 들여쓸 때 탭 문자를 사용하지 말고 스페이스를 사용해요.

숫자처럼 보이지만 문자열로 보관할 값은 따옴표 사용과 읽힌 값의 형식을 확인해요. 예를 들어 인증번호 "012345"를 숫자로 처리하면 앞의 0을 잃을 수 있어요. 프로그램의 YAML 버전과 데이터 검사 규칙도 영향을 줄 수 있어요.

왜 알아야 할까요?

설정 오류가 났을 때 공백 문제와 잘못된 항목 이름을 나누어 확인할 수 있어요. AI에게 수정 요청을 할 때도 값만 바꿀지 목록 구조를 바꿀지 구체적으로 말할 수 있어요.

조금 더 자세히

YAML의 현재 이름은 YAML Ain’t Markup Language입니다. .yaml과 .yml 확장자를 사용하며, 매핑·시퀀스·스칼라 같은 데이터 구조를 표현합니다. 예시의 title은 매핑의 이름이고 tags의 값은 목록입니다.

YAML은 설정을 실행하는 프로그램 자체가 아닙니다. GitHub Actions나 Docker Compose처럼 읽는 도구가 각 필드의 의미를 정합니다. 구문 분석에 성공해도 해당 도구의 설정 규칙에 맞지 않으면 실행이 실패할 수 있습니다.

직접 사용할 때 확인해 보세요

항목이 속한 들여쓰기 깊이를 확인한다
값의 자료형과 따옴표를 확인한다
이 파일을 읽는 도구의 설정 규칙을 확인한다

참고 자료

YAML · 1.2.2 명세

관계 지도

YAML(YAML Ain’t Markup Language)의 정의와 관련 개념 간 관계를 설명한 계층형 그래프 — YAML(YAML Ain’t Markup Language) 중심으로 관련 개념의 정의와 관계를 한눈에 정리했습니다.

현재 개념 YAML(YAML Ain’t Markup Language)

함께 쓰일 때의 의미

JSON(JavaScript Object Notation) 같은 데이터를 다른 문법으로 표현할 수 있는 형식입니다. 프론트매터(Front Matter) 문서 앞부분의 메타데이터를 YAML로 적는 경우가 많습니다. CI/CD(Continuous Integration / Continuous Delivery · Deployment) 자동 빌드·배포 작업을 YAML 설정으로 작성하는 도구가 있습니다. 도커(Docker) Docker Compose의 서비스 설정을 YAML로 작성할 수 있습니다.