Markdown to PowerPoint Conversion

Convert a Markdown file to PowerPoint presentation using pandoc.

When to Use

• User wants to convert Markdown to PowerPoint/PPT
• User mentions "轉簡報", "轉 PPT", "md2pptx"
• User asks to create slides from a markdown file

Instructions

1. Read the Markdown File

Use Read tool to examine the file content.

2. Format Check (Critical)

Before conversion, verify and fix these issues:

A. Bold text with colon followed by list must have blank line:

❌ Wrong:
**重點**:
- item 1
- item 2

✅ Correct:
**重點**:

- item 1
- item 2

B. YAML header should be present:

---
title: "Presentation Title"
author: "Author Name"
date: "2025-01-01"
---

C. Heading levels for slides:

• # = Section title (new section)
• ## = Slide title (new slide)
• ### = Content heading within slide

3. Fix Issues If Found

Use Edit tool to fix any formatting issues before conversion.

4. Run Pandoc Conversion

pandoc "<input_file>.md" -o "<output_file>.pptx" --slide-level=2

With custom template (optional):

pandoc "<input_file>.md" -o "<output_file>.pptx" --slide-level=2 --reference-doc="template.pptx"

5. Report Result

✅ 轉換完成！

| 項目 | 結果 |
|------|------|
| 輸入 | {input_file} |
| 輸出 | {output_file} |
| 格式修正 | {fixes_made or "無"} |

檔案位置：{full_output_path}

Common Issues & Fixes

Example Usage

/md2pptx 演講稿.md
/md2pptx /Users/yourname/Documents/presentation.md