creating-marp-slides
本项目中Marp幻灯片创建规则。在创建、图像布局、构建和预览幻灯片时使用。图像应放置在slides/images/目录下,使用bun run preview/build进行构建。
📖 中文导读:本项目中Marp幻灯片创建规则。在创建、图像布局、构建和预览幻灯片时使用。图像应放置在slides/images/目录下,使用bun run preview/build进行构建。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: creating-marp-slides description: このプロジェクトでの Marp スライド作成ルール。スライド作成、画像配置、ビルド、プレビュー時に使用。画像は slides/images/ に配置、bun run preview/build を使用。
Marp スライド作成スキル
本プロジェクトにおける Marp スライド作成の固有ルールと設定。
画像配置(重要)
スライドで使用する画像は 必ず slides/images/ に配置。


理由: Marp CLI サーバーモードはルート以下のみ配信。他の場所では CLI プレビューで表示されない。 参考: GitHub Issue #163
ファイル配置
| 種類 | パス |
|---|---|
| スライド | slides/*.md |
| 画像 | slides/images/ |
| カスタムテーマ | themes/*.css |
| 出力 | dist/ |
開発コマンド
# プレビュー(ルートから実行)
bun run preview
# → http://localhost:8080/slides/[ファイル名].md
# ビルド
bun run build # HTML + PDF
bun run build:html # HTML のみ
bun run build:pdf # PDF のみ
bun run build:pptx # PPTX のみ
設定(.marprc.yml)
allowLocalFiles: true # ローカル画像読み込み許可
themeSet: ./themes # カスタムテーマディレクトリ
html: true # HTML タグ許可
その他のオプション(inputDir, output 等)については Marp CLI 公式ドキュメント を参照。
Front Matter 必須設定
---
marp: true
theme: default # または gaia, uncover
paginate: true # 推奨
---
テーマ選択
default: ビジネス向け、シンプルgaia: カラフル、視覚的uncover: ミニマル、テキスト中心
注意: invert クラスは default テーマで最も安定。gaia では期待通りに動作しない場合あり。