--- title: YAML構文徹底解説_IT研修講師向け tags: author: [Yukiko](https://docswell.com/user/yukiko_it) site: [Docswell](https://www.docswell.com/) thumbnail: https://bcdn.docswell.com/page/P7R9Q265E9.jpg?width=480 description: YAML構文徹底解説_IT研修講師向け by Yukiko published: July 02, 26 canonical: https://docswell.com/s/yukiko_it/53JJWV-2026-07-02-190019 --- # Page. 1 ![Page Image](https://bcdn.docswell.com/page/P7R9Q265E9.jpg) IT研修講師向け 徹底解説シリーズ YAML構文 徹底解説 原理原則から、画像生成・動画生成の実務活用まで 国内・海外の一次情報（YAML公式仕様／Red Hat／IBM／Rubyist Magazine 他）にもとづき、 「コピペで終わらない」理解と実践演習を1本にまとめました。 うさうさ研修工房｜面白きこともなき世を面白く # Page. 2 ![Page Image](https://bcdn.docswell.com/page/PJXQ5DMX7X.jpg) AGENDA 本日のゴールと進め方 この研修は「WHY → WHAT → HOW」の3部構成です。単なる構文暗記ではなく、なぜ・何を・どう使うかを一気通貫で扱います。 WHY なぜ学ぶのか WHAT → 何を理解するのか HOW → どう使いこなすのか YAMLの位置づけと 原理原則・構文・ 演習と実践パターンで 現場での必要性を理解する 仕様の変遷を図解でつかむ 手を動かして定着させる YAML構文 徹底解説｜うさうさ研修工房 2 # Page. 3 ![Page Image](https://bcdn.docswell.com/page/3JK96XG9JD.jpg) WHY なぜ今、 YAMLを学ぶ必要があるのか インフラ・ CI/CD GitHub Actions、Docker Compose、Kubernetesの設定はほぼ YAML 画像生成 AI ComfyUI／InvokeAIのワークフロー、 Stable Diffusion系のプリセット YAML構文 徹底解説｜うさうさ研修工房 AIエージェント構成 LangChain・AutoGen・CrewAIなど、AIエージェントの構成定義に採用 動画・コンテンツ制作 ストーリーボードやレンダリングパイプラインの構造化に活用 3 # Page. 4 ![Page Image](https://bcdn.docswell.com/page/LE3W65N9E5.jpg) WHY YAMLの成り立ちと位置づけ 2001 2005 2009 2021 YAML誕生 (Clark Evans他) YAML 1.1 (Norway Problem含む型推論) YAML 1.2 JSONの正式な上位互換に 1.2.2 公式仕様の整備・現行版 データ記述形式としての立ち位置（海外一次情報より） 観点 YAML JSON XML 構造の表現 インデント 括弧 {} [] 開始/終了タグ コメント 書ける（#） 書けない 書ける（<!-- -->） 人間の可読性 高い 中程度 低い（冗長） JSONとの関係 1.2以降は上位互換 ― 非互換 YAML構文 徹底解説｜うさうさ研修工房 4 # Page. 5 ![Page Image](https://bcdn.docswell.com/page/8EDKVDW87G.jpg) WHAT 原理原則：たった 3つのデータ構造で全部表せる YAML公式仕様（yaml.org）は、スカラー・シーケンス・マッピングという型システムを核として定義しています。この 3つの組み合わせだけで、あらゆるデータを表現 できます。 スカラー シーケンス マッピング Scalar Sequence Mapping 単一の値。文字列・数値・真偽値・null。 name: 山田太郎 age: 30 YAML構文 徹底解説｜うさうさ研修工房 順序付きのリスト（配列）。 skills: - Python - YAML キーと値のペアの集合（辞書）。 address: city: 東京 zip: 100-0001 5 # Page. 6 ![Page Image](https://bcdn.docswell.com/page/V7PKVX9WJ8.jpg) WHAT インデントの図解：階層はスペースだけで決まる タブ文字は使用不可。同じ階層は必ず同じ幅で揃える一貫性が、 YAMLの構文ルールの中核です。 profile: name: Sakura contact: email: sakura@example.com social: name: Sakura email: sakura@... contact profile social: @sakura_dev skills twitter: "@sakura_dev" skills: - Python - Python / YAML / Docker - YAML - Docker YAML構文 徹底解説｜うさうさ研修工房 6 # Page. 7 ![Page Image](https://bcdn.docswell.com/page/2JVVZLM9JQ.jpg) WHAT 発展構文①：アンカー（ &）とエイリアス（ *） 同じ値を何度も書かない仕組み。共通設定を 1箇所にまとめ、変更を 1点集中管理できます。 base_style: &base_style quality: "high detail, 8k" negative_prompt: "blurry" scene_a → 白いうさぎ &base_style（原本） scene_b → 桜並木 *base_styleで呼び出し scene_a: <<: *base_style subject: " 白いうさぎ " scene_b: <<: *base_style subject: " 桜並木" 発展構文②：複数行文字列（ | と >） ｜ 改行を保持 ＞ 改行をスペースに変換 台本・セリフ・ナレーション向き 説明文・キャプション向き YAML構文 徹底解説｜うさうさ研修工房 7 # Page. 8 ![Page Image](https://bcdn.docswell.com/page/5EGL4XG4JL.jpg) WHAT 落とし穴の正体： YAML 1.1→1.2 の仕様変更 YAML公式仕様（yaml.org, Revision 1.2.2）によれば、 1.2での最大の変更点は「コア型スキーマ」の導入です。ここを知らないと初心者が必ずハマります。 項目 YAML 1.1 YAML 1.2（現行） 真偽値と解釈される文字列 true/false に加え y, yes, on 等も真偽値化 （＝通称『ノルウェー問題』） true / false のみ （y, yes, on はただの文字列） 数値の記法 8進数は先頭0のみでOK 8進数は 0o プレフィックス必須 マージキー << 使用可能 仕様上は削除（実装依存で残存） JSONとの関係 多くは互換 正式にJSONの上位互換と規定 講師向けポイント： 「NO」「Off」「Yes」のようなクォートなしの文字列が、パーサーによって真偽値扱いされることがあります。国名コード「 NO（ノルウェー）」がtrueやfalseとして誤解釈 された事例が有名で、俗に「ノルウェー問題」と呼ばれます。実務では文字列にしたい値は必ずクォートで囲む、と徹底させるのが指導の勘所です。 YAML構文 徹底解説｜うさうさ研修工房 8 # Page. 9 ![Page Image](https://bcdn.docswell.com/page/4JQYG8XR7P.jpg) HOW 演習①：この YAML、どこが間違い？ 受講者に「なぜ動かないか」を言語化させてから正解を見せると定着率が上がります。 ❌ Before（エラーになる） character: ✅ After（正しい） character: hair_color: silver hair_color: silver outfit: navy suit outfit: navy suit lighting: type: soft light art_style: name: NO lighting: type: soft light art_style: name: "NO" 誤り3点：①hair_colorのインデントが1マス不足 ②タブ文字混入 ③NOがクォートなしで真偽値と誤解釈される YAML構文 徹底解説｜うさうさ研修工房 9 # Page. 10 ![Page Image](https://bcdn.docswell.com/page/K74W526QE1.jpg) HOW 演習②：重複コードをアンカーでリファクタリング 「同じ設定を 3回コピペしている」状態を見せ、アンカー・エイリアスで 1箇所にまとめる書き換えを体験させます。 Before：3シーンで設定を毎回コピペ scene_a: quality: high detail negative: blurry subject: うさぎ scene_b: quality: high detail negative: blurry subject: 桜並木 After：アンカーで一元管理 base: &base quality: high detail negative: blurry scene_a: <<: *base subject: うさぎ scene_b: <<: *base subject: 桜並木 修正コスト：共通設定の変更が 1箇所で完結。行数も約 25%削減。 YAML構文 徹底解説｜うさうさ研修工房 10 # Page. 11 ![Page Image](https://bcdn.docswell.com/page/LJ1YWMVLEG.jpg) HOW 実践活用パターン：現場の 3つの入口 CI/CD自動化 画像生成プリセット 動画ストーリーボード GitHub Actions Stable Diffusion系 シーン管理 on: [push] jobs: prompt: positive: "1girl..." build: steps: negative: "blurry" parameters: - run: npm test YAML構文 徹底解説｜うさうさ研修工房 scenes: - id: 1 camera: close-up duration_sec: 5 steps: 28 11 # Page. 12 ![Page Image](https://bcdn.docswell.com/page/GJWG63LQ72.jpg) TIPS 研修講師向け：教え方のコツ 『閉じ括弧がない』を最初に強調 JSON経験者ほど「終わりはどこ？」と混乱する。インデント＝構造、を体で覚えさ せる演習を先に。 『書かせる』前に『読ませる』 既存のGitHub Actions／ComfyUIワークフローYAMLを読み解く時間を最初に取る と自走度が上がる。 YAML構文 徹底解説｜うさうさ研修工房 エラーは実際に起こしてから見せる タブ混入・インデント不揃いをわざと再現し、パーサーのエラーメッセージを読む練 習をセットにする。 検証ツールを教材に組み込む オンラインのYAMLバリデーター／YAML→JSON変換ツールを常時開かせ、自己解 決させる。 12 # Page. 13 ![Page Image](https://bcdn.docswell.com/page/4EZLYVM373.jpg) まとめ • YAMLは3つのデータ構造（スカラー／シーケンス／マッピング）だけで全データを表現する • 階層はインデントのみで決まる。タブ禁止・幅の一貫性が最重要ルール • アンカー／エイリアス／複数行文字列で、実務では『使い回す』設計ができる • 1.1→1.2の仕様変更（ノルウェー問題など）を知らないと必ずハマる • CI/CD・画像生成・動画生成、すべて同じ原理原則の応用でしかない 参考情報（国内・海外一次情報） • YAML Ain't Markup Language (YAML™) 1.2.2 — 公式仕様（yaml.org） • Red Hat「YAML in a Nutshell」「YAML explained for ROSA users」 • IBM「YAMLとは」／CircleCI「YAML入門」 • プログラマーのためのYAML入門（るびま）／Qiita技術備忘録 うさうさ研修工房｜面白きこともなき世を面白く