YAML JSON 変換

はい、完全に無料です。登録もアカウントも利用制限も有料化の壁もありません。このページのすべての機能を、誰でもいつでも使えます。

いいえ。変換はブラウザ内でJavaScriptによって実行されます。YAMLがどこかに送信されることはありません — サーバー側の変換エンドポイントも、ログも、貼り付けた内容の解析もありません。変換中にブラウザのネットワークタブを開くか、インターネットを切断して確認できます。ページはそのまま動き続けます。

いいえ。これはオンラインのYAML→JSON変換ツールで、すでに開いているブラウザのタブで動きます。ダウンロードもコマンドラインツールも拡張機能も不要です。オンライン変換ツールはどこで変換を行うかを決めなければなりません — 多くはドキュメントをサーバーに送りますが、このツールはあなたの端末内に留めます。スクリプトで変換したい場合は、ガイド「コードでYAMLをJSONに変換する」でコマンドライン、Python、Node.js、Goを扱っています。

人為的な上限はありません。変換はお使いの端末で行われるため、実質的な制限は端末のメモリです。数メガバイトのファイルは問題なく変換できます。非常に大きなドキュメントでは、解析中にページが一時的に止まることがあります。

はい。2つのペインの間にある入れ替えボタンでページを離れずに方向を反転できます。専用のJSON→YAML変換ツールもあります。入れ替えると現在の出力が新しい入力として引き継がれるため、ドキュメントを往復変換できます。

JSONにはコメントの構文がないため削除されます。変換ツールは黙って捨てるのではなく、いくつ削除したかを表示します。コメントを残す必要がある場合は、YAMLをその場で整形しコメントを保持するYAMLフォーマッターを使ってください。

--- でドキュメントを区切ったファイルは完全にサポートされています。すべてのドキュメントを含むJSON配列として出力するか、1行に1つのコンパクトなJSONオブジェクトを並べるJSON Lines（NDJSON）として出力できます。後者はkubectlや多くのログパイプラインが期待する形式です。KubernetesのマニフェストやHelmの出力は通常マルチドキュメントです。

はい。JSONには参照を表す手段がないため、アンカー（&name）とエイリアス（*name）は完全な値に展開されます。マージキー（<<）はデフォルトで解決されます。Docker Compose、GitLab CI、Ansibleのファイルはこれに依存しています。生の << キーを見たい場合はマージの解決をオフにできます。

YAML 1.2は引用符のない no、yes、on、off などの値を通常の文字列として扱います。YAML 1.1はこれらを真偽値として扱うため、country: no は false になります。YAML 1.1はさらに 022 を8進数の18として、12:30 を60進数の750として読みます。この変換ツールはデフォルトでYAML 1.2を使い、ドキュメント内の値が1.1では異なって読まれる場合に警告します。

最も多い原因は2つです。YAMLが完全に禁止しているタブ文字によるインデントと、title: foo: bar のようなコロンを含む引用符なしの値です。閉じられていない括弧や引用符も、多くのパーサーではインデントエラーとして現れます。この変換ツールはそれらを個別に検出し、閉じられていない区切り文字を指し示します。

はい。ドキュメントを解析できない場合、問題の平易な説明、正確な行と列、修正案、そしてエディタ上の該当行のマーカーが表示されます。専用のYAMLバリデーターページは同じエンジンで、出力ペインを診断に特化させたものです。

一度読み込めば動きます。変換に必要なものはすべてブラウザ内にあるため、接続が切れてもツールは動き続けます。

このページ上部の変換ツールの左ペインにYAMLを貼り付けてください。ブラウザ内で入力と同時にオンラインで変換されるため、押すボタンもアップロードもありません。インデントを2スペース、4スペース、タブ、圧縮から選び、必要ならキーをソートして、JSONをコピーするか .json ファイルとしてダウンロードします。ドキュメントを解析できない場合は、空の出力ペインではなく、正確な行と列、平易な説明、修正案が表示されます。繰り返し行う変換なら、ターミナルで yq -o=json input.yaml が同じ仕事をします。

「アップロード」を押して .yaml または .yml ファイルを選ぶか、このページのどこかにドラッグしてから「ダウンロード」を押すと、結果が .json ファイルとして保存されます。ファイルはブラウザが読み取り、どこにも送信されません。ホスト名やレジストリ、認証情報を含む設定ファイルでは重要な点です。シェルからなら yq -o=json input.yaml > output.json、ディレクトリ全体なら for f in *.yaml; do yq -o=json "$f" > "${f%.yaml}.json"; done で一括変換できます。

ほぼすべてのケースで可能です。YAML 1.2はJSONのスーパーセットとして定義されており、通常のマッピング、シーケンス、文字列、数値、真偽値、nullで構成されたYAMLドキュメントには正確なJSONの対応物があります。変換で失われるのは4つです。JSONに構文がないコメント。JSONは参照を表せないため完全な値に展開されるアンカーとエイリアス。日付やネストした構造など、JSONが許さない文字列以外のマッピングキー。そして !Ref や !GetAtt のような、固有のツールの外では意味を持たないカスタムタグです。この変換ツールはこれらを黙って捨てず、それぞれ報告します。

逆です。JSONは有効なYAMLですが、YAMLは一般に有効なJSONではありません。YAML 1.2の仕様はこの言語をJSONのスーパーセットと定義しているため、どんなJSONドキュメントもそのままYAML 1.2パーサーに渡せます — 上のYAMLペインにJSONを貼り付けても解析されます。YAMLドキュメントが有効なJSONになるのは、JSONのフロースタイルですべてのキーと文字列を引用符で囲み、コメントを含まない場合だけです。通常のインデントベースのYAMLはどのJSONパーサーにも拒否されます。なおこの保証はYAML 1.2に対するものです — PyYAMLや古いツールが実装するYAML 1.1はJSONの厳密なスーパーセットではありません。

JSONは機械向けの厳格な交換形式で、YAMLは同じデータを表現できる人向けの設定形式です。具体的には、YAMLはインデントから構造を得るのに対しJSONは波括弧と角括弧を使います。YAMLは # によるコメントをサポートしますがJSONにはコメントがありません。YAMLはアンカー、エイリアス、マージキーでブロックを再利用できますがJSONはすべての値を丸ごと繰り返します。YAMLは --- で区切って1ファイルに複数のドキュメントを持てますがJSONはちょうど1つの値です。そしてYAMLは通常文字列を引用符なしで書けますが、country: NO が false と読まれるまでは便利です。YAML 1.2はJSONのスーパーセットなので、JSONで表現できるものはYAMLでも表現できます。

人がファイルを書いて保守するならYAML、機械が書くか読むならJSONです。YAMLはコードレビューで読まれる設定で元が取れます — Kubernetesマニフェスト、Docker Compose、GitHub Actionsワークフロー、Ansibleプレイブック、OpenAPI仕様など。コメントで値を説明でき、アンカーで繰り返しを減らせるからです。JSONはAPIのリクエスト・レスポンスボディ、ログ行、テストフィクスチャ、大量に生成・保存されるあらゆるもので元が取れます。解析が速く、どの言語にもパーサーがあり、間違えやすい意味のある空白も、議論になるバージョンの曖昧さもありません。両方の理由が当てはまるなら、通常の答えはYAMLで書いてビルド時にJSONに変換することで、このページ上部の変換ツールはそのためにあります。

YAMLは読みやすく正しく書くのが難しい。JSONは冗長ですがはるかに予測可能です。可読性では、ネストした設定でYAMLが明らかに勝ります。閉じ括弧なし、すべてのキーを引用符で囲む必要なし、置き間違えるカンマなし、自明でない値を説明するコメントあり — 同じKubernetesマニフェストはJSONよりYAMLの方が約40%短くなります。使いやすさでは逆転します。インデントが意味を持つため、迷い込んだタブや揃っていない兄弟キーがドキュメントを壊します。引用符のない値は黙って型が変わります（yes、no、on、off、022、12:30）。重複キーとYAML 1.1と1.2の分裂は、正常に解析されるのに誤って動作するファイルを生みます。そしてYAMLパーサーのエラーは本当の問題の場所について悪名高いほど曖昧です。JSONにはこれらの失敗モードが一切ないため、実務的な立場は「YAMLで書き、出荷前に検証または変換する」です。