YAML（YAML Ain't Markup Language）

• 人間が読み書きしやすい形式
• インデント（空白）で階層構造を表現
• 設定ファイルでよく使われる（Docker Compose、Kubernetes、GitHub Actionsなど）
• コメントをサポート（# で始まる行）
• ファイル拡張子: .yaml, .yml

name: MyApp
version: 1.0.0
settings:
  debug: true
  features:
    - logging
    - caching

JSON（JavaScript Object Notation）

• プログラムで処理しやすい形式
• 波括弧とカンマで構造を表現
• Web APIのデータ交換でよく使われる
• 厳密な構文規則（ダブルクォート必須、末尾カンマ不可など）
• ファイル拡張子: .json

{
  "name": "MyApp",
  "version": "1.0.0",
  "settings": {
    "debug": true,
    "features": ["logging", "caching"]
  }
}

Docker Compose（YAML）

version: '3.8'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
  db:
    image: postgres:14
    environment:
      POSTGRES_PASSWORD: secret

package.json（JSON）

{
  "name": "my-app",
  "version": "1.0.0",
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  },
  "dependencies": {
    "react": "^18.0.0"
  }
}

GitHub Actions（YAML）

name: CI
on:
  push:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run tests
        run: npm test

Q. YAMLとJSONはどちらを使うべきですか？

A. 用途によります。設定ファイルなど人間が編集するものはYAMLが読みやすく、Web APIなどプログラム間のデータ交換にはJSONが適しています。YAMLはコメントが書けるため、ドキュメントとしての価値も高いです。

Q. YAMLのコメントは変換されますか？

A. JSONはコメントをサポートしていないため、YAML→JSON変換時にコメントは失われます。JSON→YAML変換では、元々コメントがないため影響ありません。

Q. インデントのエラーが出ます

A. YAMLではインデントが構造を表すため、スペースの数が重要です。タブではなくスペースを使用し、同じレベルの要素は同じインデント幅にする必要があります。一般的には2スペースまたは4スペースを使用します。

Q. 大きなファイルも変換できますか？

A. ブラウザ上で処理するため、非常に大きなファイル（数MB以上）の場合はパフォーマンスが低下する可能性があります。通常の設定ファイルサイズであれば問題なく動作します。

キーと値

key: value
number: 123
boolean: true
null_value: null

リスト（配列）

# ハイフン記法
items:
  - apple
  - banana
  - orange

# インライン記法
items: [apple, banana, orange]

ネストしたオブジェクト

person:
  name: John
  age: 30
  address:
    city: Tokyo
    country: Japan

複数行の文字列

# 改行を保持（|）
description: |
  This is a
  multiline
  string

# 改行をスペースに変換（>）
description: >
  This is a
  long text