SKILL.md
Markdown → スライド変換 Skill
MarkdownドキュメントをPowerPointプレゼンテーションに変換します。
クイックスタート
python scripts/md2slides.py input.md output.pptx
Markdown記法
スライド区切り
| 記法 |
動作 |
# 見出し1 |
タイトルスライドを作成 |
## 見出し2 |
新しいコンテンツスライドを作成 |
--- |
強制的にスライドを分割 |
サポートする要素
- 太字 と 斜体 テキスト
- 箇条書きリスト（2階層までネスト可）
- 番号付きリスト
- コードブロック（等幅フォントで表示）
- 画像
 （ローカルパスのみ）
ワークフロー
- ソースMarkdownを読み込む - Readツールでコンテンツ取得
- PPTXに変換 - 変換スクリプトを実行
- 出力を確認 - 生成ファイルの存在確認
スクリプトインターフェース
入力
python scripts/md2slides.py <input.md> [output.pptx] [--title "タイトル"]
出力
- 成功: 出力パスを stdout に表示、終了コード 0
- 失敗: エラーを stderr に表示、終了コード 1
オプション
--title: プレゼンテーションタイトルを上書き（デフォルト: 最初のH1またはファイル名）--theme: カラーテーマ（default, dark, corporate）--aspect: アスペクト比（16:9, 4:3）デフォルト: 16:9
エラーハンドリング
| エラー |
原因 |
対処 |
| 入力ファイルが見つからない |
パスが間違っている |
パスを確認 |
| 無効なMarkdown |
構文エラー |
該当箇所をスキップして警告 |
| 画像が見つからない |
パスが間違っている |
プレースホルダーを表示 |
使用例
基本的な使い方
python scripts/md2slides.py presentation.md slides.pptx
オプション指定
python scripts/md2slides.py notes.md output.pptx --title "Q4レビュー" --theme corporate
テスト実行
cd /path/to/markdown-to-slides
pytest tests/ -v
依存関係
- python-pptx（Claude API環境ではプリインストール済み）
- 標準ライブラリのみ（パース処理）
ファイル構成
markdown-to-slides/
├── SKILL.md # このファイル
├── scripts/
│ ├── md2slides.py # CLIエントリポイント
│ ├── parser.py # Markdownパース
│ └── generator.py # PPTX生成
├── tests/
│ └── test_md2slides.py
└── resources/
└── example.md # サンプル入力
