JSON to YAML コンバーター

YAMLとは何ですか？なぜJSONから変換するのですか？

// Convert JSON to YAML in Node.js using the eemeli/yaml library
import { Document } from 'yaml';

const data = JSON.parse('{"apiVersion":"apps/v1","kind":"Deployment"}');

// version: '1.1' ensures Norway-problem strings (yes/no/on/off/y/n)
// are automatically quoted in the output for YAML 1.1 parser safety
const doc = new Document(data, { version: '1.1' });

const yamlString = doc.toString({
  indent: 2,
  lineWidth: 0,         // disable line wrapping
  defaultStringType: 'PLAIN',   // Auto mode: only quote when needed
});

console.log(yamlString);
// apiVersion: apps/v1
// kind: Deployment

主な機能

サンプル

{"apiVersion":"apps/v1","kind":"Deployment","metadata":{"name":"my-app","namespace":"production","labels":{"app":"my-app","version":"1.0.0"}},"spec":{"replicas":3,"selector":{"matchLabels":{"app":"my-app"}},"template":{"metadata":{"labels":{"app":"my-app"}},"spec":{"containers":[{"name":"my-app","image":"my-app:1.0.0","ports":[{"containerPort":8080}],"resources":{"requests":{"memory":"64Mi","cpu":"250m"},"limits":{"memory":"128Mi","cpu":"500m"}}}]}}}}

{"version":"3.9","services":{"web":{"image":"nginx:1.25-alpine","ports":["80:80","443:443"],"environment":{"NGINX_HOST":"example.com","NGINX_PORT":"80"},"depends_on":["db"],"restart":"unless-stopped"},"db":{"image":"postgres:16-alpine","environment":{"POSTGRES_DB":"mydb","POSTGRES_USER":"admin","POSTGRES_PASSWORD":"secret"},"volumes":["pgdata:/var/lib/postgresql/data"]}},"volumes":{"pgdata":{}}}

{"name":"CI","on":{"push":{"branches":["main"]},"pull_request":{"branches":["main"]}},"jobs":{"build":{"runs-on":"ubuntu-latest","steps":[{"uses":"actions/checkout@v4"},{"name":"Set up Node.js","uses":"actions/setup-node@v4","with":{"node-version":"20","cache":"pnpm"}},{"name":"Install dependencies","run":"pnpm install --frozen-lockfile"},{"name":"Run tests","run":"pnpm test"}]}}}

{"openapi":"3.0.3","info":{"title":"User API","version":"1.0.0","description":"Manage application users"},"paths":{"/users":{"get":{"summary":"List users","operationId":"listUsers","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}}}}},"/users/{id}":{"get":{"summary":"Get user","operationId":"getUser","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"}}}}},"components":{"schemas":{"User":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"}}}}}}

{"name":"my-app","version":"1.0.0","description":"A sample Node.js application","private":true,"scripts":{"dev":"vite","build":"tsc && vite build","preview":"vite preview","test":"vitest","lint":"eslint . --ext .ts,.tsx"},"dependencies":{"react":"^18.3.0","react-dom":"^18.3.0"},"devDependencies":{"typescript":"^5.4.0","vite":"^5.2.0","vitest":"^1.5.0","eslint":"^8.57.0","@types/react":"^18.3.0"},"engines":{"node":">=20.0.0","pnpm":">=9.0.0"}}

{"format_version":"1.0","terraform_version":"1.7.4","variables":{"region":{"value":"us-east-1"}},"planned_values":{"root_module":{"resources":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","values":{"bucket":"my-app-assets","force_destroy":false,"tags":{"Environment":"production","ManagedBy":"terraform"}}}]}},"resource_changes":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","change":{"actions":["create"],"before":null,"after":{"bucket":"my-app-assets","force_destroy":false}}}]}

使い方

1. 1

   JSONを貼り付ける

   上の入力欄にJSONデータを入力または貼り付けてください。「サンプルを読み込む」をクリックして、Kubernetes Deployment・Docker Composeファイル・Terraformプランなどのサンプルを試すこともできます。

2. 2

   YAML出力をリアルタイムで確認

   YAMLは即座に出力パネルに表示されます。オプション（インデント2/4、クォート自動/ダブル/シングル、スタイルブロック/フロー）を調整して、対象ツールの要件に合わせてください。

3. 3

   コピーまたはダウンロード

   「コピー」でYAMLをクリップボードに取得するか、「ダウンロード」でkubectl apply・docker compose up・その他のツールにすぐ使える.yamlファイルとして保存してください。

よくある変換ミス

{"name": "Alice", "role": "admin",}

{"name": "Alice", "role": "admin"}

{'name': 'Alice', 'active': true}

{"name": "Alice", "active": true}

{name: "Alice", role: "admin"}

{"name": "Alice", "role": "admin"}

{"port": 8080 // HTTP port}

{"port": 8080}

# JSON input: {"country": "no", "enabled": "yes"}
# YAML without quoting (dangerous):
country: no
enabled: yes
# YAML 1.1 parser reads: country=false, enabled=true

# YAML with Auto quoting (safe):
country: 'no'
enabled: 'yes'
# YAML 1.1 parser reads: country="no", enabled="yes"

// JSON input (resourceVersion is int64 on K8s server)
{"resourceVersion": 9007199254740993}
// JavaScript reads it as: 9007199254740992 (precision lost)
// YAML output will contain the wrong number

// Store large integers as strings to preserve precision
{"resourceVersion": "9007199254740993"}
// YAML output: resourceVersion: '9007199254740993' (exact)

よくある使用場面

Kubernetesマニフェスト

kubectl get -o json やKubernetes APIからのJSONレスポンスをYAMLマニフェストに変換し、GitOpsワークフロー・Kustomizeオーバーレイ・kubectl apply -f デプロイに使用します。

Docker Composeファイル

docker inspect のJSON出力やプログラムで生成されたサービス設定を、docker compose upやDocker Stackデプロイと互換性のあるdocker-compose.yamlファイルに変換します。

Helm Chartのvalues

JSON設定のエクスポートをHelmチャートデプロイ用のYAML valuesファイルに変換し、クリーンなYAML構文でバージョン管理されたインフラ設定を実現します。

GitHub Actionsワークフロー

GitHub Actionsワークフロー定義をプログラム的にJSONで構築し、GitHub Actions runnerが必要とする.github/workflows/*.yaml形式に変換します。

OpenAPI仕様

多くのフレームワーク（FastAPI・SpringDoc）が返すJSON形式のOpenAPI/Swagger仕様を、Swagger UI・Redoc・APIゲートウェイツールが好むYAML形式に変換します。

設定の移行

JSONで保存されたアプリケーション設定（appsettings.json・config.json）をYAML形式に移行し、YAMLを必要とするまたは好むツールに対応し、コメントによるドキュメント追加も可能にします。

技術的詳細

RFC 8259準拠のJSON解析

JSON入力はブラウザのネイティブJSON.parse()を使用して解析され、RFC 8259に完全準拠しています。位置情報（ベストエフォートの行番号と列番号）を含む正確な構文エラーメッセージを提供し、文字列・数値・ブール値・null・配列・オブジェクトのすべてのJSONデータ型を処理します。

YAML 1.1スキーマのeemeli/yaml Document APIによるYAML 1.2出力

YAMLはeemeli/yamlライブラリ（v2.8+、CVE安全）のDocument APIを使用してversion: '1.1'で生成されます。この組み合わせによりYAML 1.2準拠の出力が生成されつつ、YAML 1.1クォートルールが適用されます — つまりNorway問題の文字列（yes/no/on/off/y/n）は出力で自動的にクォートされ、YAML 1.1と1.2の両パーサーで安全です。行の折り返しは無効化（lineWidth: 0）されており、長い文字列もそのまま保持されます。

100%ブラウザベース — アップロードなし、サーバーなし

すべての処理はブラウザのJavaScriptエンジン内で完結します。データはいかなる時点でもネットワーク経由で送信されません。200KBを超える入力はリアルタイムモードから手動モードへ自動的に切り替わります（明示的な「変換」クリックが必要）。ブラウザのレスポンスを維持し、重いシリアライゼーション中にメインスレッドがブロックされるのを防ぐためです。

ベストプラクティス

DevOps設定には必ず「自動」クォートモードを使用する

KubernetesやHelm・Ansible・Docker Compose・GitHub Actionsで使用するためにJSONを変換する場合は、常にデフォルトの「自動（Norway対応）」クォートモードを使用してください。これらのツールのYAML 1.1パーサーは裸の文字列yes・no・on・off・y・nを無言でブール値として誤読します — 「自動」モードはこれを透過的に防ぎます。

クラウドネイティブツールには2スペースインデントを使用する

Kubernetes・Docker Compose・GitHub Actions・Helmはすべて慣例として2スペースインデントを使用しています。これらのファイルで4スペースインデントを使用することは有効なYAMLですが、コミュニティの例・自動生成された設定・チームの既存マニフェストとの不整合が生じます。

変換前に大きな整数を文字列として保存する

KubernetesのresourceVersion・uid、およびAPIサーバーからのその他のint64フィールドはJavaScriptの安全整数範囲（2^53 - 1）を超える可能性があります。正確な数値精度が必要な場合は、変換前にこれらの値をJSON文字列として保存してください。サーバー側で生成されたフィールドを含むkubectl get -o json の出力では特に重要です。

まずJSONを検証する

JSONソースが手書きの場合や、不正な出力を生成することがあるシステム（末尾カンマ・クォートなしキー・コメント）から来ている場合は、変換前にJSONフォーマッターで検証してください。JSON整形ツール を使用して構文エラーを見つけて修正し、クリーンなJSONをYAMLに変換してください。

バージョン管理に入れるファイルにはブロックスタイルを優先する

ブロックスタイルYAMLは各フィールドが個別の行に表示されるため、Gitで見やすく人間が読みやすいdiffを生成します。フロースタイル（コンパクトなインライン形式）はdiffの読み取りとレビューを難しくします。フロースタイルはドキュメントへの短いYAMLスニペットの埋め込みやコンパクトな出力を必要とするツールのために取っておいてください。

よくある質問