テンプレート PPTX 準備ガイド

md-pptx はテンプレート PPTX ファイルのスライドレイアウトとプレースホルダを活用して、Markdown から PowerPoint を生成します。このガイドでは、md-pptx が認識するプレースホルダの種類と、推奨するレイアウト構成を説明します。

md-pptx が認識するプレースホルダ

md-pptx は PowerPoint のプレースホルダ type（PP_PLACEHOLDER_TYPE）に基づいて、以下の4種類を認識します。

プレースホルダ type	type 値	md-pptx 内部名	用途
TITLE	1	title	スライドタイトル
CENTER_TITLE	3	title	中央配置タイトル（Title Slide 等）
BODY	2	body	本文テキスト
OBJECT	7	body	コンテンツプレースホルダ（Title and Content 等）
SUBTITLE	4	subtitle	サブタイトル
PICTURE	18	picture	画像

上記以外の type（日付、スライド番号、フッターなど）は other として扱われ、コンテンツのマッピング対象にはなりません。

推奨レイアウト構成

md-pptx のレイアウト自動選択が最も効果的に機能するよう、以下の4つのレイアウトをテンプレートに含めることを推奨します。

1. 「Title and Content」相当

プレースホルダ: title + body

最も汎用的なレイアウトです。見出し＋本文、見出し＋リスト、見出し＋テーブルなど、多くのスライドで使用されます。

┌──────────────────────────┐
│  [title]                 │
├──────────────────────────┤
│                          │
│  [body]                  │
│                          │
│                          │
└──────────────────────────┘

2. 「Title Slide」相当

プレースホルダ: title + subtitle

プレゼンテーションの表紙や、セクション区切りのタイトルスライドに適しています。

┌──────────────────────────┐
│                          │
│       [title]            │
│                          │
│       [subtitle]         │
│                          │
└──────────────────────────┘

3. 「Section Header」相当

プレースホルダ: title のみ

見出しだけのスライドに使用されます。セクションの区切りに適しています。

┌──────────────────────────┐
│                          │
│                          │
│       [title]            │
│                          │
│                          │
└──────────────────────────┘

4. 「Blank」相当

プレースホルダ: なし

プレースホルダを持たないレイアウトです。md-pptx がスライド内のどの要素もプレースホルダにマッピングできなかった場合のフォールバック先として使用されます。Blank レイアウトでは、コード側のデフォルト値で全コンテンツが自由配置されます。

┌──────────────────────────┐
│                          │
│                          │
│                          │
│                          │
│                          │
└──────────────────────────┘

テンプレート作成のベストプラクティス

レイアウト名を標準名に揃える

md-pptx はまずレイアウト名で検索し、見つからない場合にプレースホルダ type で検索します。以下の標準名を使用すると、レイアウト選択の精度が上がります。

• Title and Content — title + body レイアウト
• Title Slide — title + subtitle レイアウト
• Section Header — title のみレイアウト
• Blank — プレースホルダなしレイアウト

プレースホルダの type を正しく設定する

PowerPoint でレイアウトを編集する際、プレースホルダの type が意図通りに設定されていることを確認してください。特に以下の点に注意が必要です。

• テキスト用のプレースホルダは TITLE（type=1）または BODY（type=2）/ OBJECT（type=7）を使用する
• 画像用のプレースホルダは PICTURE（type=18）を使用する
• PowerPoint のレイアウト編集画面で「プレースホルダーの挿入」から適切な種類を選択する

フォントとスタイルをプレースホルダに設定する

md-pptx は基本的にプレースホルダのデフォルトスタイル（フォント種類、色など）を継承します。テンプレートのプレースホルダに企業フォントやブランドカラーを設定しておけば、生成される PowerPoint にもそのスタイルが反映されます。

詳細なスタイル適用ルールについては、Markdown → PowerPoint マッピング仕様を参照してください。

関連ドキュメント

• Markdown 記法仕様 — サポートされる Markdown 記法の詳細
• Markdown → PowerPoint マッピング仕様 — Markdown 要素がどのようにプレースホルダにマッピングされるかの仕様