YAML Formatter: YAML 검증 및 형식화

YAML Formatter란?

YAML Formatter는 YAML 텍스트를 파싱하고 검증하며 일관된 설정 가능한 들여쓰기로 재직렬화하는 브라우저 기반 도구입니다. YAML의 들여쓰기 감지 구문은 하나의 잘못 정렬된 블록이 전체 문서의 의미를 변경하거나 시각적으로 찾기 어려운 오류를 생성할 수 있음을 의미합니다. 이 도구는 그러한 문제를 즉시 감지하고 원하는 스타일에 맞는 깔끔한 출력을 생성합니다.

기본 형식화 외에도 YAML을 직접 JSON으로 변환합니다. API나 도구가 JSON을 요구하지만 소스 설정이 YAML일 때, 또는 YAML이 예상 데이터 구조로 파싱되는지 확인할 때 유용합니다. 두 작업 모두 js-yaml 라이브러리를 사용하여 브라우저에서 완전히 실행됩니다. 데이터가 기기를 떠나지 않고, 계정이 필요 없으며, 무료입니다.

주요 기능

올바른 들여쓰기로 YAML 형식화 — js-yaml로 입력을 파싱하고 선택한 들여쓰기 크기로 재출력합니다. lineWidth: -1 옵션은 포매터가 긴 문자열에 줄바꿈을 삽입하는 것을 방지하고, noRefs: true는 앵커와 별칭을 완전한 값으로 확장합니다.
오류 메시지와 함께 YAML 구문 검증 — js-yaml이 파싱 오류를 발생시키면 정확한 오류 메시지(줄 번호 포함)가 출력 패널 아래에 표시됩니다. 오류는 접근 가능한 role="alert" 속성을 사용합니다.
YAML을 JSON으로 변환 — YAML을 파싱하고 선택한 들여쓰기로 JSON.stringify를 사용하여 JSON 형식으로 결과를 직렬화합니다. 다운로드 로직은 출력이 { 또는 [로 시작하는지 감지하고 자동으로 .json 확장자로 파일을 저장합니다.
형식화된 출력을 클립보드에 복사 — textarea 폴백이 있는 Clipboard API를 사용합니다.
.yaml 또는 .json 파일로 다운로드 — 출력이 JSON(변환 작업에서)이면 파일이 formatted.json으로 저장됩니다. 출력이 YAML(형식화 작업에서)이면 formatted.yaml로 저장됩니다.
키보드 단축키 — Ctrl+Enter(Cmd+Enter)로 형식화, Ctrl+Shift+J(Cmd+Shift+J)로 JSON 변환.

YAML Formatter 사용 방법

1단계: YAML 붙여넣기

/developer/code/yaml-formatter의 도구로 이동합니다. 왼쪽 입력 패널에 YAML을 붙여넣습니다. 텍스트 영역은 고정폭이며 크기 조정이 가능합니다. 브라우저 메모리에 맞는 모든 크기의 YAML 문서가 허용됩니다. 도구는 크기 제한을 두지 않습니다.

2단계: 들여쓰기 선택

패널 아래 작업 표시줄에서 들여쓰기 드롭다운을 엽니다. 2 공백 또는 4 공백을 선택합니다. 선택은 Format 출력과 JSON 변환 출력 모두에 영향을 미칩니다. 2공백 들여쓰기는 YAML 커뮤니티 기본값이며 Kubernetes 매니페스트, Ansible 플레이북, 대부분의 CI/CD 파이프라인 파일에서 사용됩니다. 4공백 들여쓰기는 일부 Python 및 Java 프로젝트 규칙과 일치합니다.

3단계: 형식화 또는 변환

오른쪽 패널에 정규화된 YAML 출력을 생성하려면 Format을 클릭하거나 Ctrl+Enter / Cmd+Enter를 누릅니다. 동등한 JSON 문서를 생성하려면 To JSON을 클릭하거나 Ctrl+Shift+J / Cmd+Shift+J를 누릅니다.

입력 예시: 들여쓰기가 불일치하는 Kubernetes Deployment 매니페스트:

apiVersion: apps/v1
kind: Deployment
metadata:
    name: web-frontend
    labels:
      app: web
spec:
  replicas: 3
  selector:
      matchLabels:
        app: web
  template:
      metadata:
        labels:
          app: web
      spec:
        containers:
        - name: nginx
          image: nginx:1.25
          ports:
          - containerPort: 80

2공백 들여쓰기로 Format 후 출력:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-frontend
  labels:
    app: web
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.25
          ports:
            - containerPort: 80

4단계: JSON으로 변환 (선택 사항)

입력에 동일한 YAML을 넣은 상태에서 To JSON을 클릭합니다. 출력 패널이 동등한 JSON 문서를 표시합니다:

{
  "apiVersion": "apps/v1",
  "kind": "Deployment",
  "metadata": {
    "name": "web-frontend",
    "labels": {
      "app": "web"
    }
  }
}

(간략화를 위해 생략 — 전체 문서에는 spec이 포함됩니다)

5단계: 복사 또는 다운로드

출력을 클립보드에 복사하려면 Copy를 클릭합니다. 파일을 저장하려면 Download를 클릭합니다. 도구는 출력이 JSON처럼 보이는지({ 또는 [로 시작하는지)에 따라 자동으로 .yaml 또는 .json을 파일 확장자로 선택합니다.

실용적인 예시

CI/CD 파이프라인 파일 정규화

GitHub Actions 워크플로 파일이 여러 기여자에 의해 편집되어 들여쓰기가 혼합되어 있습니다. 포매터에 붙여넣고 2공백 들여쓰기로 Format을 클릭하면 출력이 전체적으로 일관된 들여쓰기를 보여줍니다. 변경을 커밋하기 전에 입력과 출력을 비교하여 의미적 차이가 없음을 확인하세요. YAML은 들여쓰기 감지이므로 재형식화로 원본에 숨어있던 정렬 버그가 드러날 수 있습니다.

설정 구조 검증

Node.js 애플리케이션의 설정 파일을 YAML로 배포하지만 런타임은 파싱된 JavaScript 객체로 읽습니다. 설정을 붙여넣고 To JSON을 클릭합니다. JSON 출력은 타입 변환(bare true/false → boolean, 따옴표 없는 숫자 → 숫자)을 포함하여 파싱된 객체가 정확히 어떻게 보이는지 보여줍니다. 이를 통해 port: 8080과 같은 값이 문자열 "8080"이 아닌 숫자임을 확인할 수 있습니다.

입력:

server:
  host: 0.0.0.0
  port: 8080
  debug: false
database:
  url: postgres://localhost:5432/myapp
  pool: 10

JSON 출력:

{
  "server": {
    "host": "0.0.0.0",
    "port": 8080,
    "debug": false
  },
  "database": {
    "url": "postgres://localhost:5432/myapp",
    "pool": 10
  }
}

YAML 앵커 확장

YAML은 값 재사용을 위한 앵커(&)와 별칭(*)을 지원합니다. 포매터는 noRefs: true를 사용하므로 모든 별칭이 출력에서 완전한 값으로 확장됩니다. 이를 통해 형식화된 문서가 자기 완결적이 되고 앵커를 지원하지 않는 도구에서도 읽기 쉬워집니다.

팁과 모범 사례

포매터는 키 순서를 유지합니다. js-yaml 덤프 옵션에는 sortKeys: false가 포함되어 있어 키 순서가 형식화된 출력에서 그대로 유지됩니다. 이는 기술적으로 필수는 아니더라도 필드 순서가 관례를 갖는 Kubernetes 및 Ansible 문서에 중요합니다.

긴 문자열은 줄바꿈되지 않습니다. lineWidth: -1 설정은 자동 줄바꿈을 비활성화합니다. 여러 줄 문자열과 긴 값은 임의의 열에서 줄바꿈되는 대신 한 줄에 유지됩니다. 줄바꿈된 출력이 필요한 경우 결과를 복사하고 편집기에서 줄바꿈을 적용하세요.

버전 관리에 커밋하기 전에 검증하세요. YAML 들여쓰기 오류는 CI 실패의 일반적인 원인입니다. 푸시하기 전에 파이프라인 파일을 이 포매터를 통해 실행하세요. 오류 메시지 없이 깔끔한 형식화 통과는 YAML이 구문적으로 유효함을 확인합니다.

다운로드 시 파일 확장자를 확인하세요. 다운로드 로직은 수행한 작업이 아닌 출력 내용을 검사합니다. YAML을 형식화했는데 그 YAML이 우연히 {로 시작하면(일부 YAML 파일은 JSON 호환 구문을 사용), 파일이 .json으로 저장됩니다. 필요한 경우 이름을 변경하세요.

YAML boolean은 엄격합니다. YAML 사양은 YAML 1.1에서 true, false, yes, no, on, off를 boolean 값으로 인식합니다. js-yaml 라이브러리는 기본적으로 YAML 1.2를 따르며 true와 false만 boolean입니다. YAML에서 yes/no를 사용하면 포매터는 이를 일반 문자열로 처리합니다.

일반적인 문제와 해결 방법

줄 번호와 열 번호가 있는 오류 메시지 — js-yaml 파싱 오류는 문제의 정확한 위치를 포함합니다. 입력에서 지정된 줄을 확인하세요. 일반적인 원인: 공백 대신 탭을 들여쓰기에 사용(YAML은 탭을 허용하지 않음), 따옴표 없는 문자열 내의 콜론(예: url: http://example.com은 url: "http://example.com" 또는 블록 스칼라를 사용해야 함), 또는 잘못된 중첩 수준.

출력에 입력에 있던 값이 없음 — YAML에 js-yaml이 인식하지 못하는 !! 타입 태그(예: !!binary, !!timestamp)가 포함된 경우 해당 값이 삭제되거나 변환될 수 있습니다. 타입 태그를 식별하기 위해 특정 값을 검사하고 필요한 경우 값을 따옴표로 묶으세요.

"Please enter YAML to format" 오류 — Format 또는 변환을 클릭했을 때 입력 필드가 비어 있거나 공백만 있었습니다. 먼저 입력 패널에 YAML을 붙여넣으세요.

변환된 JSON에 예상치 못한 null 값이 있음 — ~의 YAML 값이나 빈 값(콜론 뒤에 값이 없는 키)은 JSON에서 null이 됩니다. 이는 올바른 동작으로 YAML 사양과 일치합니다. 문자열 "~" 또는 빈 문자열 ""을 의도했다면 값을 따옴표로 묶으세요.

다운로드가 .yaml 대신 .json으로 저장됨 — 다운로드 핸들러는 출력이 { 또는 [로 시작하는지 확인합니다. 일부 YAML 문서는 JSON 호환 YAML 구문으로 작성되어 중괄호로 시작합니다. 이 경우 저장 후 다운로드된 파일 이름을 .yaml로 변경하세요.

개인 정보 보호 및 보안

YAML Formatter는 js-yaml 라이브러리를 사용하여 모든 입력을 브라우저에서 로컬로 처리합니다. 붙여넣은 텍스트(데이터베이스 연결 문자열, API 토큰, 개인 키 또는 개인 설정 데이터 포함)는 어떤 서버로도 전송되지 않습니다. 페이지를 로드한 후에는 네트워크 연결 없이 작동합니다. 형식화 작업에 대한 세션 추적은 없습니다.

자주 묻는 질문

YAML Formatter는 무료인가요? 네, 사용 제한 없이 완전 무료입니다. 모든 형식화, 검증, 변환 작업이 무료로 제공됩니다. Glyph Widgets 후원자 기능(저장된 프리셋, 세션 기록, 도구 메모)은 Ko-fi 후원자를 위해 제공되지만 핵심 YAML 기능에는 아무것도 필요하지 않습니다.

오프라인에서 작동하나요? 네. 모든 처리가 브라우저에서 실행됩니다. 페이지를 로드한 후 인터넷에서 연결을 끊고 계속해서 포매터와 컨버터를 중단 없이 사용할 수 있습니다.

데이터는 안전한가요? 네. YAML 입력은 서버로 전송되지 않습니다. 브라우저 메모리에만 존재하며 지우기를 클릭하거나 탭을 닫으면 삭제됩니다.

포매터가 YAML 멀티 문서 파일(여러 --- 섹션)을 지원하나요? js-yaml의 load 함수는 스트림에서 첫 번째 문서를 파싱합니다. 멀티 문서 YAML 파일(---으로 구분)은 첫 번째 문서만 형식화됩니다. 멀티 문서 파일에는 yaml.loadAll 동작을 사용하세요. 단, 이 도구는 현재 첫 번째 문서만 처리합니다.

Format과 To JSON의 차이점은 무엇인가요? Format은 파싱된 YAML을 일관된 들여쓰기로 YAML로 재직렬화합니다. To JSON은 동일한 파싱된 데이터를 JSON 문서로 직렬화합니다. 두 작업 모두 동일한 파싱 단계를 사용하므로 둘 다 YAML을 검증하고 잘못된 입력에 동일하게 실패합니다.

포매터가 주석을 보존하나요? 아니요. js-yaml 파서가 파싱 시 주석을 삭제합니다. 형식화 후 원래 입력의 주석이 출력에 나타나지 않습니다. 주석을 보존해야 하는 경우 소스 파일에서 들여쓰기를 수동으로 편집하세요.

JSON을 YAML로 변환할 수 있나요? 이 도구는 YAML을 JSON으로 변환합니다. 반대 방향으로 변환하려면 JSON-to-YAML 변환을 지원하는 곧 출시 예정: JSON Converter 도구를 사용하세요.

도구가 어떤 YAML 버전을 지원하나요? js-yaml 라이브러리는 YAML 1.2를 구현하며, YAML 1.1보다 boolean 값 및 일부 엣지 케이스에 더 엄격합니다. 최신 YAML 파일(Kubernetes, Docker Compose, GitHub Actions 등) 대부분은 YAML 1.2와 호환되게 작성되어 있습니다.

JSON으로 변환하는 키보드 단축키는 무엇인가요? Windows/Linux에서는 Ctrl+Shift+J, macOS에서는 Cmd+Shift+J를 눌러 JSON으로 변환 작업을 실행합니다. 형식화는 Ctrl+Enter 또는 Cmd+Enter를 누르세요.

다운로드 시 파일 확장자가 수행한 작업을 반영하나요? 직접적으로는 아닙니다. 다운로드 핸들러는 .json과 .yaml 간 결정에 출력 텍스트가 { 또는 [로 시작하는지 확인합니다. 매핑으로 시작하는 형식화된 YAML 출력은 .yaml로 저장되고, JSON 변환 출력(항상 { 또는 [로 시작)은 .json으로 저장됩니다.

YAML Formatter란?

주요 기능

올바른 들여쓰기로 YAML 형식화 — js-yaml로 입력을 파싱하고 선택한 들여쓰기 크기로 재출력합니다. lineWidth: -1 옵션은 포매터가 긴 문자열에 줄바꿈을 삽입하는 것을 방지하고, noRefs: true는 앵커와 별칭을 완전한 값으로 확장합니다.
오류 메시지와 함께 YAML 구문 검증 — js-yaml이 파싱 오류를 발생시키면 정확한 오류 메시지(줄 번호 포함)가 출력 패널 아래에 표시됩니다. 오류는 접근 가능한 role="alert" 속성을 사용합니다.
YAML을 JSON으로 변환 — YAML을 파싱하고 선택한 들여쓰기로 JSON.stringify를 사용하여 JSON 형식으로 결과를 직렬화합니다. 다운로드 로직은 출력이 { 또는 [로 시작하는지 감지하고 자동으로 .json 확장자로 파일을 저장합니다.
형식화된 출력을 클립보드에 복사 — textarea 폴백이 있는 Clipboard API를 사용합니다.
.yaml 또는 .json 파일로 다운로드 — 출력이 JSON(변환 작업에서)이면 파일이 formatted.json으로 저장됩니다. 출력이 YAML(형식화 작업에서)이면 formatted.yaml로 저장됩니다.
키보드 단축키 — Ctrl+Enter(Cmd+Enter)로 형식화, Ctrl+Shift+J(Cmd+Shift+J)로 JSON 변환.

YAML Formatter 사용 방법

1단계: YAML 붙여넣기

2단계: 들여쓰기 선택

3단계: 형식화 또는 변환

입력 예시: 들여쓰기가 불일치하는 Kubernetes Deployment 매니페스트:

apiVersion: apps/v1
kind: Deployment
metadata:
    name: web-frontend
    labels:
      app: web
spec:
  replicas: 3
  selector:
      matchLabels:
        app: web
  template:
      metadata:
        labels:
          app: web
      spec:
        containers:
        - name: nginx
          image: nginx:1.25
          ports:
          - containerPort: 80

2공백 들여쓰기로 Format 후 출력:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-frontend
  labels:
    app: web
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.25
          ports:
            - containerPort: 80

4단계: JSON으로 변환 (선택 사항)

입력에 동일한 YAML을 넣은 상태에서 To JSON을 클릭합니다. 출력 패널이 동등한 JSON 문서를 표시합니다:

{
  "apiVersion": "apps/v1",
  "kind": "Deployment",
  "metadata": {
    "name": "web-frontend",
    "labels": {
      "app": "web"
    }
  }
}

(간략화를 위해 생략 — 전체 문서에는 spec이 포함됩니다)

5단계: 복사 또는 다운로드

실용적인 예시

CI/CD 파이프라인 파일 정규화

설정 구조 검증

입력:

server:
  host: 0.0.0.0
  port: 8080
  debug: false
database:
  url: postgres://localhost:5432/myapp
  pool: 10

JSON 출력:

{
  "server": {
    "host": "0.0.0.0",
    "port": 8080,
    "debug": false
  },
  "database": {
    "url": "postgres://localhost:5432/myapp",
    "pool": 10
  }
}

YAML 앵커 확장

팁과 모범 사례

일반적인 문제와 해결 방법

"Please enter YAML to format" 오류 — Format 또는 변환을 클릭했을 때 입력 필드가 비어 있거나 공백만 있었습니다. 먼저 입력 패널에 YAML을 붙여넣으세요.

개인 정보 보호 및 보안

자주 묻는 질문

데이터는 안전한가요? 네. YAML 입력은 서버로 전송되지 않습니다. 브라우저 메모리에만 존재하며 지우기를 클릭하거나 탭을 닫으면 삭제됩니다.

YAML Formatter: YAML 검증 및 형식화

YAML Formatter란?

주요 기능

YAML Formatter 사용 방법

1단계: YAML 붙여넣기

2단계: 들여쓰기 선택

3단계: 형식화 또는 변환

4단계: JSON으로 변환 (선택 사항)

5단계: 복사 또는 다운로드

실용적인 예시

CI/CD 파이프라인 파일 정규화

설정 구조 검증

YAML 앵커 확장

팁과 모범 사례

일반적인 문제와 해결 방법

개인 정보 보호 및 보안

자주 묻는 질문

관련 도구

계속 읽기

YAML Formatter: YAML 검증 및 형식화

YAML Formatter란?

주요 기능

YAML Formatter 사용 방법

1단계: YAML 붙여넣기

2단계: 들여쓰기 선택

3단계: 형식화 또는 변환

4단계: JSON으로 변환 (선택 사항)

5단계: 복사 또는 다운로드

실용적인 예시

CI/CD 파이프라인 파일 정규화

설정 구조 검증

YAML 앵커 확장

팁과 모범 사례

일반적인 문제와 해결 방법

개인 정보 보호 및 보안

자주 묻는 질문

관련 도구

계속 읽기