creating-marp-slides
このプロジェクトでの Marp スライド作成ルール。スライド作成、画像配置、ビルド、プレビュー時に使用。画像は slides/images/ に配置、bun run preview/build を使用。
When & Why to Use This Skill
This Claude skill provides a standardized workflow for creating professional presentations using Marp and Markdown. It streamlines the slide development process by enforcing specific rules for image management, directory structures, and automated build commands using Bun, ensuring seamless previews and high-quality exports in HTML, PDF, and PPTX formats.
Use Cases
- Technical Presentations: Rapidly generating developer-centric slide decks directly from Markdown files within a coding environment.
- Standardized Asset Management: Ensuring all slide images are correctly placed and referenced to prevent broken links during Marp CLI previews and builds.
- Automated Documentation Workflows: Integrating slide generation into CI/CD or local development loops using Bun-based build scripts for consistent output.
| 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 では期待通りに動作しない場合あり。