YAML ファイル形式とは？
.yaml は、さまざまなアプリケーション間でデータを交換するために使用されるテキストファイル形式です。YAML（*YAML Ain't Markup Language* の略）は、UTF-8 でエンコードされたインデントベースの key: value ペアを使用して、人間が読みやすくプラットフォームに依存しない形式で情報を整理するための標準規格です。.yaml ファイルを解析するには YAML ライブラリをインストールする必要があります。一般的なライブラリには PyYAML (Python)、js-yaml (JavaScript)、SnakeYAML (Java) などがあります。.yaml ファイルは .yml 拡張子で保存されることもありますが、機能的には同一です。データ交換以外にも、.yaml ファイルは通常、データのシリアル化や、Docker Compose、Kubernetes、GitHub Actions などのツールでの設定ファイルの記述に使用されます。
シリアル化（Serialization）
シリアル化はコンピュータサイエンスで使用される用語です。シリアル化とは、データやオブジェクトを、保存、送信、および後で再構成できる形式に変換するプロセスです。例えば、異なるアプリケーションを使用して標準化された形式でデータを交換する 2 つの機関は、送信前にそのデータをシリアル化する必要があります。シリアル化されたデータは、.yaml、.xml、.json、.toml などのファイルに保存してから受信者に送信することもできます。
.yaml ドキュメントは、オプションで --- ドキュメント開始マーカーで始まり、... で終わることができます。これにより、1 つのファイル内に複数のドキュメントを含めることも可能です。YAML 1.2（2009年、2021年改訂）以降、すべての有効な JSON ファイルは有効な YAML でもあります。
セキュリティと安全性
リスク： MEDIUMYAML ファイルはプレーンテキストであり、それ自体は実行されないため、読み取りは安全です。2 つの現実的なリスクがあります。(1) 設定 YAML（CI パイプライン、Compose、K8s、Ansible）には、トークン、パスワード、キーなどの機密情報が含まれることが多いため、信頼できないオンラインバリデータに貼り付けたり、公開リポジトリにコミットしたりしないでください。(2) プログラム上の危険性：信頼できない YAML を安全でないパーサー（例：PyYAML の yaml.safe_load ではなく yaml.load）で読み込むと、任意のオブジェクトやコードが実行される可能性があります。信頼できないファイルには常に安全なローダーを使用してください。編集上のリスク：タブやずれたスペースが意味を密かに変えてしまう可能性があるため、編集後は検証を行ってください。
形式の詳細
概要YAML ファイルを開くプログラム
Windows4 apps
Visual Studio Code
無料 ファイルを開くと、組み込みまたは Red Hat の YAML 拡張機能がハイライト、インデントガイド、スキーマ検証、エラー表示を提供します。YAML に最適な選択肢です。 
macOS3 apps
Visual Studio Code
無料 ファイルを開くと、組み込みまたは Red Hat の YAML 拡張機能がハイライト、インデントガイド、スキーマ検証、エラー表示を提供します。YAML に最適な選択肢です。 
Linux3 apps
Visual Studio Code
無料 ファイルを開くと、組み込みまたは Red Hat の YAML 拡張機能がハイライト、インデントガイド、スキーマ検証、エラー表示を提供します。YAML に最適な選択肢です。 
vim / nano
オープンソース ターミナルで編集します。Vim ではインデントにスペースを使用するために «:set expandtab» を使用してください。サーバー設定ファイルの標準的な方法です。
Web1 app
YAML Lint / online YAML validators
無料 ファイルを貼り付けて構文を検証し、ブラウザ上で整形表示します。設定 YAML には機密情報が含まれることが多いため、シークレット情報は貼り付けないでください。 技術的詳細
詳細仕様| ファイル拡張子 | .yaml (または .yml) |
| MIME タイプ | application/yaml |
| エンコーディング | UTF-8 プレーンテキスト。バイナリヘッダーやマジックバイトなし |
| 構造 | インデントベースの key: value ペア。インデントにはスペースのみを使用し、仕様によりタブは禁止 |
| ドキュメントマーカー | --- はドキュメントの開始、... はドキュメントの終了。1つのファイルに複数のドキュメントが共存可能 |
| ネイティブデータ型 | 文字列、整数、浮動小数点数、ブール値、null、シーケンス（リスト）、マッピング（辞書）、タイムスタンプ |
| 仕様バージョン | YAML 1.2 (2009年、2021年改訂)。YAML 1.1 (2005年) および YAML 1.0 (2001年) を継承 |
| JSON 互換性 | YAML 1.2 以降、すべての有効な JSON ドキュメントは有効な YAML でもある。JSON は厳密なサブセット |
| コメント | # で始まる単一行コメント。独自の行、または値の後のインラインとして記述可能 |
| 複数行文字列 | リテラルブロックスカラー (|) は改行を保持し、折り返しブロックスカラー (>) は改行をスペースに変換 |
| アンカーとエイリアス | & は名前付きアンカーを定義し、* はそれを参照（エイリアス）することで、重複なしで値を再利用可能 |
| 開発者 | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| 一般的なユースケース | 設定ファイル (Kubernetes, Docker Compose, GitHub Actions, Ansible)、データシリアル化、OpenAPI 定義 |
| 引用符 | 引用符なし、単一引用符 ('...')、二重引用符 ("...") の文字列をすべてサポート。二重引用符はエスケープシーケンスを許可 |
| リリース日 | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| オープンスタンダード | はい · ロイヤリティフリー |
| 仕様書 | yaml.org |
YAML の変換
可能
.YAML .JSONガイド
はい - YAML と JSON は同じデータモデルを共有しているため、変換はロスレス（無劣化）です。YAML のコメントのみが削除されます。
変換方法
.YAML .XMLガイド
はい - YAMLとXMLはどちらも階層データを記述するため、変換は簡単です。ただし、YAMLの各キーはXMLの属性ではなく、子要素になります。
変換方法
.YAML .TOMLガイド
はい、YAMLはTOMLに変換可能です。最も速い方法は、yq -o=toml file.yaml > file.tomlという1つのyqコマンドを使用することです。
変換方法
.YAML .CSVガイド
はい - ただし、.yaml ファイルがフラットで均一なレコードのリストである場合に限ります。Kubernetes マニフェストや CI パイプラインのようなネストされた設定ファイルには、意味のある表形式は存在しません。
変換方法
.YAML .YMLガイド
はい - .yaml と .yml は同じ形式です。ファイル名を変更するだけで完了します。
変換方法
コミュニティ Q&A
ユーザーからの質問
I
よくある質問
.yaml と .yml の違いは何ですか？
違いはありません。2 つの拡張子を持つ同じ YAML 形式です。.yml は古い 3 文字の形式です。ツールが想定している方を使用してください。単にファイル名を変更するだけで対応可能です。
.yaml ファイルはどうやって開きますか？
任意のコード/テキストエディタで開けます。構造をハイライトし、インデントエラーを指摘してくれる VS Code（YAML 拡張機能付き）が最適です。Notepad++ や Sublime も機能します。プレーンテキストなので メモ帳 でも開けますが、YAML が重視する空白文字が表示されません。
YAML でインデント/パースエラーが出るのはなぜですか？
YAML は構造にスペースを使用し、タブを禁止しているため、迷い込んだタブや行のずれがエラーの原因になります。YAML 対応のエディタ（空白を表示し、タブをスペースに変換する設定）で開くか、オンラインの YAML バリデータに貼り付けて正確な行を特定してください。
YAML を JSON に変換するにはどうすればよいですか？
«yq -o=json file.yaml» コマンド、VS Code のコマンド、またはオンラインコンバーターを使用します。JSON は YAML のサブセットであるため、コメントが削除される以外は基本的にロスレス（無損失）で変換可能です。
YAML でタブを使用できますか？
いいえ。YAML ではインデントにスペースのみが許可されており、タブはパースエラーを引き起こします。エディタの設定でスペースを挿入するように設定してください（例：Vim の «:set expandtab»、Sublime の «translate tabs to spaces»）。
YAML は Python 専用ですか？
いいえ、それはよくある誤解です。YAML は言語に依存せず、Docker Compose、Kubernetes、GitHub Actions、Ansible、Go/Java/JS アプリなど、あらゆる場所で使用されています。Python にはたまたま有名な YAML ライブラリ（PyYAML）があるだけです。
参考文献
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
