JSON から YAML へ
JSONを貼り付けるだけで、Happycapyが構造とデータ型を保ったまま、きれいにインデントされたYAMLを返します。APIレスポンスやJSONデータを、設定ファイル・CIパイプライン・Kubernetesマニフェストで使われる読みやすいYAMLに変換するのに最適です。無料で始められます。
JSONがYAMLになる仕組み
JSONを貼り付けて、構造化データを読みやすいYAML設定やドキュメントに変換します。
JSONを貼り付ける
JSONをドロップします。APIレスポンス、設定オブジェクト、任意のJSONデータなど。
インデントを選ぶ
2スペースか4スペースのインデントを指定するか、きれいな2スペースのデフォルトを使います。
読みやすいYAMLを得る
ツールがJSONを、構造とデータ型を保った、きちんとインデントされたYAMLに変換します。
コピーまたはダウンロード
YAMLを設定ファイルにコピーするか、プロジェクト用にダウンロードします。
JSONをYAMLに変換する人
APIデータ、アプリ設定、構成情報をYAMLベースのツールへ移す開発者に便利です。
DevOps・プラットフォームエンジニア
JSONを、Kubernetes、Docker Compose、CI/CDパイプラインが好むYAMLに変換できます。
設定を書く開発者
JSONペイロードを、保守しやすい設定ファイル向けの、よりきれいで人が編集しやすいYAMLに変換できます。
設定を手で編集する方
YAMLはJSONより読み書きしやすいので、一度変換して親しみやすい形式で作業できます。
きれいにJSONをYAMLへ変換するコツ
キー順、インデント、配列、真偽値、null、コメントが最終的なYAMLを形作ります。
JSONが有効か確認する
末尾のカンマ、コメント、引用符なしのキーは解析に失敗します。先に直しましょう。
インデントを選ぶ
プロジェクトの慣習に合わせて、2スペースか4スペースを指定しましょう。
型を引用符なしに保つ
数値とブール値を引用符なしに保つよう指定し、YAMLが元の通りに振る舞うようにしましょう。
深いネストは長い出力を想定
深くネストしたJSONは長いYAMLになります。読みやすさを確認しましょう。
特殊文字の引用を受け入れる
コロンや先頭記号を含む文字列は、YAMLを有効に保つため自動で引用符が付きます。これは想定通りです。
機密の値を削除する
変換前に、JSONからトークンや個人データを取り除きましょう。
JSONからYAMLで期待できること
JSONからYAMLへの出力品質、追加確認、ダウンロード時の想定を確認しましょう。
有効なJSONであれば、変換は高速かつ確実で、データ型を保ったままきれいに正しくインデントされたYAMLが生成されます。標準的なAPIレスポンスや設定オブジェクトは問題なく変換されます。よくある問題は、元のJSONが無効な場合（末尾のカンマや引用符なしのキーなど）で、その場合は先に修正する必要があります。
例：あるユーザーがサービス設定を記述したJSONオブジェクトを貼り付け、2スペースのYAMLを依頼しました。ツールは、キーを引用符なしにし、servicesの配列を箇条書きリストとして、versionは文字列のまま、レプリカ数は引用符なしの数値のままにした、読みやすいYAMLを返しました。
YAML出力の注意点
元情報に次が含まれる場合はこのセクションを確認してください: キー順、インデント、配列、真偽値、null、コメントが最終的なYAMLを形作ります。
- 元のJSONは有効である必要があります — 末尾のカンマ、コメント、引用符なしのキーは、先にパースエラーの原因になります。
- 非常に大きい、または深くネストされたJSONは長いYAMLを生成するため、読みやすさの確認が必要な場合があります。
- JSONにはコメントを持ち越す仕組みがないため、自分で追加しない限りYAML出力にコメントは含まれません。
よくある質問
JSON to YAML コンバーターは何をしますか?
JSONを読み取り、同じデータを設定でよく使われる、より人間が読みやすい形式であるYAMLとして出力します。両方の形式は同じデータ構造を表現するため、キー、ネスト、配列、値の型はそのまま保持されます。
なぜJSONをYAMLに変換するのですか?
YAMLは手作業での読み書きが容易なため、設定ファイル、CI/CDパイプライン、KubernetesやDocker Composeなどのツールで好まれる形式です。JSONペイロードをYAMLに変換することで、メンテナンスしやすくなります。
インデントを制御できますか?
はい — 2スペースまたは4スペースのインデントを指定でき、それに応じてYAMLがフォーマットされます。指定しない場合は、最も一般的な慣習である、きれいな2スペースのデフォルトが使用されます。
データ型はそのまま保持されますか?
はい — 数値、ブール値、nullは引用符付き文字列ではなく、正しいYAMLスカラー値として出力されるため、パース時に元のJSONと同じように動作します。
深くネストされたJSONにも対応していますか?
はい — ネストされたオブジェクトや配列は、適切にインデントされたYAMLに変換されます。非常に深い構造は長くなることがあるため、大きな入力では出力の読みやすさを確認してください。
データのプライバシーは保たれますか?
あなたのJSONは変換のためだけに使用され、公開されることはありません。他のオンラインツール同様、トークンやパスワードなどの機密情報は貼り付けないでください。事前に機密値を伏せ字にしてください。
文字列内の特殊文字はどうなりますか?
コロンや先頭記号など、YAMLで曖昧になりうる文字を含む文字列は自動的に引用符で囲まれ、YAMLが有効なまま正しくパースし直せるようになります。
