#2.5: 構造化記法の活用

マークダウン、YAML、表形式を使いこなし、AIとの情報共有を効率化する

💡 この週で得られること

マークダウン、YAML、表形式という3つの記法を使いこなせるようになります。これにより、複雑な情報をAIに正確に伝えられるようになり、プロンプトの精度が大幅に向上します。

📖 この章で登場する用語

📝 マークダウンの基本記法

# 大見出し
## 中見出し
### 小見出し

– 箇条書き項目1
– 箇条書き項目2

1. 番号付きリスト1
2. 番号付きリスト2

**太字** または __太字__

📝 YAMLの基本記法（AI指示用）

項目名: 内容
別の項目: 別の内容

# リスト形式
参加者:
– 山田太郎
– 佐藤花子

# 階層構造
プロジェクト:
名前: 新規システム開発
予算: 300万円

⚠️ エンジニアの方へ：ここでのYAMLについて

本プログラムで紹介しているYAML記法は、「生成AIへの指示」に特化した簡易バージョンです。
システム開発で使われる厳密なYAMLでは、以下のようにクォーテーションやブラケットを使ってより正確に記述します。

# 厳密なYAMLの例
project_config:
id: 101
is_active: true
tags: [“urgent”, “backend”]

AIは賢いため、上記のような厳密な記法でなくても、インデント（字下げ）さえ合っていれば文脈を理解してくれます。ここでは「厳密さ」よりも「書きやすさ」を優先して解説しています。

オンラインセミナーでは、上記のような本格的な指示を一瞬で作成する方法なども紹介しています。

📝 表形式の基本記法

| 項目 | 内容1 | 内容2 |
|—|—|—|
| 行1 | データA | データB |
| 行2 | データC | データD |

💡 使い分けのコツ

最初は、どの記法を使うか迷うかもしれません。そんなときは、「Excelで表にするなら表形式」「設定を書くならYAML」「それ以外はマークダウン」と覚えておくと便利です。

📝 シナリオ
あなたは人事部門で働いています。新入社員研修プログラム（3日間）を作成する必要があります。
各科目の担当講師、時間配分、使用する教材を整理して、生成AIに研修スケジュールを作成してもらいたいと考えています。

✅ 1. 研修の基本情報（YAML形式）

研修名: 新入社員研修プログラム
期間: 3日間（2025年12月10日-12日）
対象: 2025年度新入社員10名
場所: 本社研修室
目的: 業務に必要な基礎知識とスキルを習得

科目:
  - プログラミング基礎
  - ビジネスマナー
  - 社内システムの使い方

担当講師:
  プログラミング基礎: 山田太郎（IT部門）
  ビジネスマナー: 佐藤花子（人事部門）
  社内システム: 鈴木一郎（総務部門）

✅ 2. 各科目の詳細（マークダウン形式）

# 科目詳細

## プログラミング基礎
- 学習時間: 8時間（1日目）
- 内容:
  - プログラミングの基本概念
  - Python入門
  - 簡単なスクリプト作成
- 教材: 「Python入門テキスト」
- 演習: 簡単な計算プログラムの作成

## ビジネスマナー
- 学習時間: 4時間（2日目午前）
- 内容:
  - 電話応対の基本
  - メールの書き方
  - 名刺交換のマナー

✅ 3. 3日間のスケジュール（表形式）

✅ 明日から使える3つのポイント

• YAMLのテンプレートをメモ帳に保存しておく。
• AIへの指示だけでなく、社内資料の作成にも応用する。
• 表形式は、Excelで作ってからテキストに変換してもOK。

• ✅マークダウンの基本記法（見出し、箇条書き）を使える
• ✅YAML形式で項目と内容を書ける
• ✅表形式で情報を整理できる