.yaml · application/yaml

YAML: YAML(インデント型データシリアライズ形式)

YAML 1.2 はインデントで階層を表す設定記述言語で、# コメント、アンカー参照、複数行文字列、--- 区切りのマルチドキュメントに対応します。

クイックアンサー: YAML 1.2 はインデントで階層を表す設定記述言語で、# コメント、アンカー参照、複数行文字列、--- 区切りのマルチドキュメントに対応します。 Kubernetes マニフェスト、GitHub Actions ワークフロー、Docker Compose、人手で編集する設定ファイル。

構造タイプ階層構造
可読性高
ネスト対応対応
LLM トークン効率中
拡張子.yaml
MIME タイプapplication/yaml
主な用途Kubernetes マニフェスト、GitHub Actions ワークフロー、Docker Compose、人手で編集する設定ファイル。

メリット

  • インラインの # コメントや中括弧なしの複数行ブロックを記述できる
  • --- 区切りにより 1 ファイル内に複数ドキュメントを格納可能
  • JSON のスーパーセットであり運用設定の視認性に優れる

注意点・トレードオフ

  • スペース数のわずかなインデントミスで構造が崩れやすい
  • YAML 1.1 では引用符なしの NO や ON が真偽値に誤変換される罠がある
  • アンカー・エイリアスなど仕様が複雑でパーサー実装負荷が高い

参考文献

YAML をローカルで変換・整形

関連エンジニアリングガイド

関連フォーマット

全24形式を見る

YAML に関するよくある質問

YAML の「ノルウェー問題(Norway problem)」とは何ですか?

YAML 1.1 では引用符なしの国コード NO や yes/on/off が文字列ではなく真偽値(false/true)と解釈される問題です。文字列は引用符で囲むか JSON 変換で確認すると安全です。

1つの YAML ファイルに複数のドキュメントを含められますか?

はい。Kubernetes マニフェストでは --- 行で複数リソースを区切るのが一般的で、YAML to JSON では複数ドキュメントを配列として一括変換できます。

.yml と .yaml で中身に違いはありますか?

いいえ。構文は完全に同一です。公式推奨は .yaml ですが、CI や Docker では短縮形の .yml も広く使われています。