~/tech-blog/posts/yaml-syntax — zsh

YAML 문법

기본 문법

들여쓰기 (indent)

들여쓰기는 기본적으로 2칸 또는 4칸을 지원합니다.

2칸 들여쓰기 (추천)

YAML
person:
  name: Coby
  job: Developer
  skills: 
    - docker
    - kubernetes

4칸 들여쓰기

YAML
person:
    name: Coby
    job: Developer
    skills: 
        - docker
        - kubernetes

데이터 정의 (map)

데이터는 key : value 형식으로 정의합니다.

YAML
apiVersion: v1
kind: Pod
metadata:
  name: echo
  labels:
        type: app

배열 정의(array)

배열은 -로 표시합니다.

YAML
person:
  name: Coby
  job: Developer
  skills:
        - doker
        - kubernetes

주석(comment)

주석은 #으로 표시합니다.

전체 라인 주석 처리

YAML
# comment
person:
  name: Coby
  job: Developer
  skills:
    - docker
    - kubernetes

일부 주석 처리

YAML
person: 
  name: Coby # subicura
  job: Developer
  skills:
    - docker
    - kubernetes

참/거짓, 숫자 표현

참/거짓은 true, false 외에 yes, no도 지원합니다.

참/거짓

YAML
study_hard: yes
give_up: no
hello: true
world: TRUE
manual: false

숫자

정수 또는 실수를 따옴표(")없이 사용하면 숫자로 인식합니다.

YAML
# number
version: 1.2

# String
version: "1.2"

줄바꿈 (newline)

여러 줄을 표현하는 방법입니다.

"|" 지시어는 마지막 줄바꿈을 포함합니다.

YAML
newlines_sample: |
            number one line
            
            second line

            last line

"|-" 지시어는 마지막 줄바꿈을 제외합니다.

YAML
newlines_sample: |-
            number one line

            second line

            last line

">" 지시어는 중간에 들어간 빈 줄을 제외합니다.

YAML
newlines_sample: >
            number one line

            second line

            last line

주의사항

띄어쓰기

key와 value 사이에는 반드시 빈칸이 필요합니다.

YAML
# error (not key-value, string)
key:value

# ok
key: value

문자열 따옴표

대부분의 문자열은 따옴표 없이 사용할 수 있지만, :가 들어간 경우는 반드시 따옴표가 필요합니다.

YAML
# error
windows_drive: c:

# ok
windows_drive: "c:"
windows_drive: 'c:'

참고

JSON을 YAML로 변환해주는 사이트입니다.

https://www.json2yaml.com/

YAML 문법을 체크해주는 사이트입니다.

http://www.yamllint.com/

이 글은 인프런의 초보를 위한 쿠버네티스 안내서을 들으며 정리한 노트입니다.

댓글

GitHub 계정으로 로그인하시면 댓글과 질문을 남기실 수 있습니다. 남겨 주신 글은 이 저장소의 Discussions에 쌓입니다.

● main 214 posts UTF-8 LF © 2026 코징 RSS · GitHub