YAML ⇄ JSON 変換
設定相互変換 · ローカル解析 · 即時プレビュー
YAML 変換
準備完了
ABOUT
YAML ⇄ JSON 変換について
YAML と JSON を素早く相互変換し、K8s manifest、CI 設定などの編集シーンに対応します。
Kubernetes、GitHub Actions、Docker Compose——YAML はクラウドネイティブ時代の lingua franca です。ローカル相互変換により、kubectl / yq 環境のないマシンでも manifest 構造を素早く確認できます。
DEEP DIVE
YAML ⇄ JSON 変換を詳しく見る
YAML は可読性の高さから Kubernetes、Docker Compose、GitHub Actions、Ansible などで広く採用されています。しかし JavaScript エコシステムは JSON のみネイティブサポートのため、YAML 設定のデバッグ時は JSON への変換が必要なことが多いです。JSONSort はブラウザ上でローカル双方向変換を完了し、yq、Python PyYAML などの CLI ツールは不要です。
変換プロセスは階層構造を保持：YAML のインデントは JSON ネストにマッピング、配列とオブジェクトのセマンティクスが正しく対応します。K8s manifest 構造の素早い検証や CI 設定の JSON ツールチェーンへのインポートに適しています。
YAML 1.1 と 1.2 はブール値（yes/no）の解析に歴史的差異があります。変換後に予期しないブールや null が現れた場合、元 YAML のインデントと引用符の使い方を照合；必要に応じて JSON 側で手動修正後に YAML に戻してください。
FEATURES
主な機能
YAML → JSON
YAML テキストを JSON オブジェクトに解析し、複数ドキュメントとアンカーに対応します。
JSON → YAML
逆方向で YAML を生成し、.yaml 設定ファイルへの書き込みを容易にします。
即時変換
貼り付け即変換、ネットワーク遅延なし、変更後すぐにプレビューできます。
構文ヒント
YAML インデントや構文エラー時に解析失敗のヒントを表示します。
ファイルインポート
.yaml / .yml ファイルのドラッグ＆ドロップインポートに対応します。
ローカル安全
K8s シークレットと内網設定はブラウザから出ません。
アンカーとエイリアス
&anchor と *alias の基本展開に対応し、DRY 設定の処理を容易にします。
双方向編集ループ
YAML → JSON 編集 → JSON → YAML。YAML インデントに不慣れな場合、まず JSON で編集するのに適しています。
HOW TO USE
使用手順
-
1
YAML または JSON を貼り付け
-
2
変換方向を選択
-
3
出力をコピーまたはファイルをエクスポート
-
4
変換失敗時はエラー表示を確認し、ソースファイルの構文を修正して再試行
-
5
結果をフォーマットツールで整形、または下流スクリプト用にエクスポート
WORKFLOW
典型的なワークフロー
データインポートから結果エクスポートまでの完全なフローで、チームの YAML ⇄ JSON 変換の使い方を統一します。
YAML をインポート
.yaml / .yml を貼り付けまたはドラッグ、元のインデントを保持します。
JSON を確認
ツリービューで apiVersion、kind、spec の階層が正しいか確認します。
編集（任意）
JSON 側で修正後 YAML に戻す、または JSON を下流ツールにコピーします。
エクスポート
結果を Git リポジトリまたは設定管理システムにコピーします。
USE CASES
適用シーン
DevOps
K8s Deployment YAML を JSON に変換後、ツリービューで構造を確認します。
バックエンド開発
GitHub Actions workflow YAML を JSON に変換してプログラム処理を容易にします。
フルスタックエンジニア
docker-compose.yml を JSON に変換して Mock やテストフレームワークにインポートします。
テクニカルライティング
ドキュメント内 YAML サンプルを JSON に変換して異なる読者層に提供します。
クラウドネイティブエンジニア
Helm values.yaml を JSON に変換して社内設定管理プラットフォームに接続します。
CI 保守者
GitHub Actions workflow を JSON に変換して静的チェックスクリプトの入力にします。
TIPS
使用のコツ
- K8s manifest 変換後にフォーマッターで確認し、apiVersion/kind 階層が正しいか検証します。
- YAML はインデントに敏感です。貼り付け時は元のスペースを保持し、Tab とスペースを混在させないでください。
- 複雑な YAML アンカー（& *）変換後、JSON ツリービューで参照が正しく展開されたか検証できます。
- JSON → YAML 出力は .yaml として直接保存し、Ansible playbook に使用できます。
- TOML ツールと連携：異なる言語エコシステムの設定形式を JSONSort 間で統一相互変換できます。
- 変換失敗時、未閉じ引用符やコロン後のスペース不足がないか確認してください。
- K8s Secret の stringData を JSON に変換後、base64 フィールドは依然として文字列であることに注意してください。
- 複数ドキュメント YAML（--- 区切り）は分割変換し、構造の混在を避けてください。
- JSON から YAML 変換後、リスト項目のインデントを確認。一部ツールは - 始まり行に敏感です。
- TOML ツールと組み合わせ：JSON を中間形式として統一してから相互変換します。
LOCAL VS ONLINE
ローカル vs オンラインツール
JSONSort は純フロントエンドアーキテクチャを堅持。以下の比較が、開発データ処理にローカルツールが適している理由を示します。
TROUBLESHOOTING
よくある誤解とトラブルシューティング
実際の使用で起こりやすい問題と推奨対処法。試行錯誤の時間を削減します。
解析失敗：bad indentation
推奨：スペースインデントを統一し、Tab を禁止；コロン後にスペースがあるか確認してください。
yes/no が true/false に
推奨：YAML 1.1 の特性。文字列が必要な場合は引用符 "yes" を追加してください。
YAML に戻すと順序が変わった
推奨：キー順は JSON と一致する可能性があります。機能に影響はありませんが、Git diff が大きくなる場合があります。
複数行文字列形式が失われた
推奨：| と > ブロックスカラーは JSON では通常文字列になり、戻す際は手動調整が必要です。
FAQ
よくある質問
Kubernetes YAML に対応していますか？
標準 YAML 構文に対応しています。--- 区切りの複数ドキュメント manifest は段ごとに変換することを推奨します。
JSON から YAML 変換でキー順序は保持されますか？
JSON オブジェクトのキー順序を可能な限り YAML 出力に保持します。
変換後に中文が文字化けしますか？
しません。UTF-8 エンコーディングを全程保持し、中文コメントと文字列は正常に保持されます。
変換で YAML コメントは保持されますか？
YAML → JSON 時にコメントは失われます（JSON はコメント非対応）。コメントはソースファイルに保存することを推奨します。
大きな manifest でカクつきますか？
数千行は通常問題ありません。超大ファイルは resource ごとに分割変換を推奨します。
データはサーバーにアップロードされる？
いいえ。JSONSort のすべてのツールはブラウザ内ローカルで動作し、入力内容はバックエンドサーバーに送信されません。
登録やインストールが必要？
不要です。ページを開くだけで使用でき、アカウント不要、クライアントダウンロード不要、PWA オフラインキャッシュにも対応。
どのくらいのファイルサイズに対応？
ブラウザメモリに依存しますが、通常数 MB 級のデータをスムーズに処理できます。超大ファイルは先に分割するかマージ・クリーンツールをご利用ください。