YAML と JSON の違いを理解して正しく使い分ける

YAML と JSON はどちらもデータ記述形式

YAML（YAML Ain't Markup Language）と JSON（JavaScript Object Notation）は、どちらも構造化データを表現するためのテキストフォーマットです。しかし、設計思想や得意な場面が異なります。

主な違い

構文のスタイル

• JSON — 波括弧 {} と角括弧 [] でネストを表現。厳密で機械に優しい。
• YAML — インデントでネストを表現。人間が読み書きしやすい。

コメント

• JSON — コメント非対応
• YAML — # でコメントを書ける

用途の傾向

用途	よく使われる形式
API レスポンス	JSON
設定ファイル（Kubernetes, GitHub Actions）	YAML
データ保存・交換	JSON
人が手書きする設定	YAML

変換時の注意点

YAML から JSON に変換する場合、以下の点に注意してください。

• コメントは消える — JSON にはコメント構文がないため、YAML のコメントは変換時に失われます
• 型の扱い — YAML は yes/no を真偽値として解釈する場合があります。JSON では true/false になります
• 複数ドキュメント — YAML は --- で複数ドキュメントを区切れますが、JSON は単一構造です

FormatArc で変換する

FormatArc の YAML to JSON ツール を使えば、ブラウザ内で即座に変換できます。構文エラーがあれば行番号付きでわかりやすく表示します。

まとめ

• JSON は機械向け、YAML は人間向けの傾向
• 変換時はコメント消失と型変換に注意
• FormatArc なら安全にブラウザ内で変換可能