marp-slides

MARP スライドスキル

MARP エコシステム（Marpit + Marp Core + marp-cli）を使って、プレーンな Markdown でスライドデッキを作成し、PDF、PowerPoint、または自己完結型 HTML にエクスポートします。デッキは単一の .md ファイルで、Git との親和性が高く、プレーンな CSS でテーマを設定できます。

このスキルが使われる場合

• ユーザーがMARPのデッキを名前を挙げて依頼した場合
• ユーザーが「Markdown スライド」または「Markdown からスライド」を希望する場合
• Git にコミットでき、同じ手順で再生成できる .md ファイルを希望する場合
• marp-cli、Marpit ディレクティブに言及するか、CSS でスライドのテーマ設定を依頼する場合
• テキストドキュメントを元に、CLI でエクスポート可能な PDF または PPTX を希望する場合

このスキルを使わない場合

ユーザーの希望	代わりに使用
スクロールナビゲーション付きの Reveal.js／ブラウザー標準の HTML プレゼンテーション	html-presentation
PowerPoint のネイティブ機能（PowerPoint で設定するアニメーション、画面切り替え）を使ってバイナリ .pptx を編集する	document-skills:pptx
静的なポスターまたは単一ページのビジュアル	concept-to-image
アニメーション付きの Manim 解説動画	animate

ステップ 0：要件を確認する

何かを生成する前に、1 回のメッセージで確認します。ユーザーが指定を省略した項目には、デフォルト値をそのまま適用します。同じ質問を繰り返してはいけません。

パラメーター	選択肢	デフォルト
エクスポート先	pdf、pptx、html、all	pdf
テーマ	dark-dashboard、light-editorial、または MARP 組み込みテーマ（default、gaia、uncover）	dark-dashboard
アスペクト比	16:9、4:3	16:9
スライド数	整数または auto	auto
ビジュアルの密度	minimal（テキスト中心）、standard（混合）、dashboard（グラフ + 指標カード）	standard
ブランディング	ロゴのパス、アクセントカラーの 16 進数コード	なし

ステップ 1：必要に応じてリファレンスを読み込む

すべてのリファレンスファイルを最初に読み込まないでください。 ユーザーの意図に応じて、必要なものだけを読み込みます。これにより、armory のトークン効率の予算内に収められます。

ユーザーの意図	読み込むもの
あらゆるデッキ（常に必須）	references/DIRECTIVES.md — Marpit ディレクティブ、フロントマターのスキーマ、画像構文
カスタムテーマまたは CSS によるスタイル設定	references/THEMES.md — dark-dashboard と light-editorial のスターター CSS
グラフ、ダッシュボード、指標カード、SVG ビジュアル	references/COMPONENTS.md — SVG グラフのレシピ、カード、ステータスタグ、アイコン
PDF／PPTX／HTML または画像へのエクスポート	references/EXPORT.md — marp-cli のフラグ、Chrome の依存関係、--html フラグ
参考にする具体例を希望する場合	references/examples/ — 厳選された 3 つのデッキ：dashboard.md、editorial.md、technical.md

ステップ 2：デッキを作成する

1. フロントマターから始めます。 すべてのデッキは、theme、paginate、header、footer、および任意でグローバルな style を設定する YAML フロントマターブロックから始めます。完全なスキーマについては DIRECTIVES.md を参照してください。
2. --- でスライドを区切ります。 単独行の水平線が新しいスライドを作成します。フロントマターは最初のスライド区切りより前に置く必要があります。
3. 最初のスライド = タイトル。 タイトルスライドを中央揃えにするには を使用し、ページ数に含めないようにするには を使用します。
4. 中間のスライド = コンテンツ。 1 枚につき 1 つのアイデアを基本とします。密度が dashboard の場合は、COMPONENTS.md の指標カードと SVG グラフを使用します。密度が minimal の場合は、大きな見出しと余白を活用します。
5. 最後のスライド = まとめ／行動喚起。 視覚的な対称性を保つため、締めくくりのスライドにも冒頭と同じクラスを使用します。
6. 背景画像には拡張構文を使います： ![bg](url)、![bg left:40%](url)、![bg brightness:0.3 blur:2px](url)。1 枚のスライドに複数の ![bg] タグを使うと、横方向に配置されます。縦方向のレイアウトにするには vertical を追加します。

ステップ 3：引き渡す前に確認する

• フロントマターブロックがあり、有効な YAML である
• theme: が既知の名前（組み込みテーマ、またはファイルのグローバルな style: ブロックで定義したカスタムテーマ）に一致している
• すべてのスライド区切りが、前後に空行を置いた単独行の --- になっている
• 相対画像パスのみを使っている（PDF エクスポートで MARP の --allow-local-files を使用するには、この指定が必要です）
• 生の HTML（SVG、カスタム div など）を使う場合、エクスポートコマンドで --html が指定されていることを確認する
• ディレクティブの警告が出ないことを確認するため、エクスポートコマンドをローカルで 1 回実行する

ステップ 4：エクスポート

コマンドの全リファレンスについては、references/EXPORT.md を参照してください。最小限の呼び出し方：

npx @marp-team/marp-cli@latest slides.md --pdf --allow-local-files --html

このスキルは、MIT ライセンスの MARP ecosystem を利用しています。上流への謝辞については、ルートの ATTRIBUTIONS.md を参照してください。

デザインルール

1. 1 枚のスライドにつきアイデアは 1 つ。 MARP ははみ出した内容を警告なしに切り捨てます。下端からはみ出した内容に対する警告はありません。
2. タイトルスライドと区切りスライドでは paginate: skip を使用します。付録スライドでは paginate: hold を使用します。
3. 画像には 相対パスのみ を使用します。絶対パスは VS Code のプレビューと PDF エクスポートで問題を起こします。
4. SVG、<div>、<details>、インラインスタイルには --html が必須 です。指定しない場合、MARP は HTML タグをテキストとしてエスケープします。
5. コンテンツスライドのリストは 6 行まで にします。それ以上の場合は、details の折りたたみ表示を使うか、スライドをもう 1 枚追加します。
6. 見出しに意味を持たせます。 スライドタイトルには h1、サブタイトルには h2、大文字のセクションラベルには h3 を使います。一貫した階層が、一貫した視覚的リズムにつながります。
7. 各スライドにテーマ CSS を直接記述しないでください。 グローバルの `` ディレクティブで一度だけ定義するか、theme: で読み込む別の .css ファイルに定義します。