.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 をローカルで変換・整形
関連エンジニアリングガイド
- JSON vs YAML vs TOML vs .env:設定ファイル形式の使い分けガイドJSON、YAML、TOML、.env の 4 つの設定フォーマットをコメント対応・ネスト・シークレット安全性・用途別で比較し、ローカルで安全に変換します。
- なぜサーバー送信型のオンライン整形ツールは危険なのか — ゼロアップロード設計の仕組み.env・JWT・顧客 CSV・契約書を外部変換サイトへ貼る危険性と、DevTools Network タブで送信量 0 バイトを確認できる仕組みを解説します。
- AI 分析前に CSV・JSON 顧客データをローカルでマスクする方法ブラウザ RAM 内で CSV 列を匿名化し、売上金額を比例スケーリング(×k)、ネスト JSON キーを構文を壊さずローカルでマスクします。
- XML から JSON への変換:属性・CDATA・RSS フィードを保持する実践ガイドXML・RSS・SVG をブラウザメモリ内で JSON に変換し、@_ 属性や CDATA テキスト、数値型を保持したまま XML への往復変換も行えます。
関連フォーマット
全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 も広く使われています。