AgentSkillsCN

markdown-to-slides

将Markdown文件转换为PowerPoint演示文稿（PPTX）的技能。 “将Markdown转换为幻灯片”“制作演示文稿”“生成PPTX” 等请求时自动触发。使用python-pptx库。

SKILL.md
--- frontmatter
name: markdown-to-slides
description: |
  MarkdownファイルをPowerPointプレゼンテーション（PPTX）に変換するSkill。
  「Markdownをスライドに変換して」「プレゼン資料を作って」「PPTXを生成して」
  などのリクエストで自動発火する。python-pptxライブラリを使用。
allowed-tools: Bash, Read, Write, Glob

Markdown → スライド変換 Skill

MarkdownドキュメントをPowerPointプレゼンテーションに変換します。

クイックスタート

bash
python scripts/md2slides.py input.md output.pptx

Markdown記法

スライド区切り

記法動作
# 見出し1タイトルスライドを作成
## 見出し2新しいコンテンツスライドを作成
---強制的にスライドを分割

サポートする要素

  • •太字 と 斜体 テキスト
  • •箇条書きリスト（2階層までネスト可）
  • •番号付きリスト
  • •コードブロック（等幅フォントで表示）
  • •画像 ![alt](path) （ローカルパスのみ）

ワークフロー

  1. •ソースMarkdownを読み込む - Readツールでコンテンツ取得
  2. •PPTXに変換 - 変換スクリプトを実行
  3. •出力を確認 - 生成ファイルの存在確認

スクリプトインターフェース

入力

bash
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構文エラー該当箇所をスキップして警告
画像が見つからないパスが間違っているプレースホルダーを表示

使用例

基本的な使い方

bash
python scripts/md2slides.py presentation.md slides.pptx

オプション指定

bash
python scripts/md2slides.py notes.md output.pptx --title "Q4レビュー" --theme corporate

テスト実行

bash
cd /path/to/markdown-to-slides
pytest tests/ -v

依存関係

  • •python-pptx（Claude API環境ではプリインストール済み）
  • •標準ライブラリのみ（パース処理）

ファイル構成

code
markdown-to-slides/
├── SKILL.md           # このファイル
├── scripts/
│   ├── md2slides.py   # CLIエントリポイント
│   ├── parser.py      # Markdownパース
│   └── generator.py   # PPTX生成
├── tests/
│   └── test_md2slides.py
└── resources/
    └── example.md     # サンプル入力