MCP Pandoc Md2pptx

🚀 mcp-pandoc-md2pptx: Markdown to PowerPoint Converter

A tool that leverages the Model Context Protocol server to convert Markdown content into professional PowerPoint (PPTX) presentations using pandoc.

🚀 Quick Start

This MCP server offers a straightforward solution for transforming Markdown content into PowerPoint presentations while maintaining the original formatting and structure. It's an ideal choice for generating presentations from documentation, notes, or any other Markdown content.

✨ Features

convert-contents

• Converts Markdown content to PowerPoint (PPTX) format.
• Inputs:
  • contents (string): The Markdown content to be converted (required if input_file is not provided).
  • input_file (string): The path to the Markdown input file (required if contents is not provided).
  • output_file (string): The complete path for the PPTX output file (required).
  • template (string): The path to a template PPTX document for styling (optional).

💻 Usage Examples

Basic Usage

{
  "mcpServers": {
    "mcp-pandoc-md2pptx": {
      "command": "uvx",
      "args": ["mcp-pandoc-md2pptx"]
    }
  }
}

Advanced Usage

"Convert this markdown to PowerPoint and save as /presentations/demo.pptx:
# My Presentation
## Slide 1
Content here"

"Convert /path/to/input.md to PPTX and save as /path/to/output.pptx"

"Convert markdown to PPTX using /templates/theme.pptx as template and save as /presentations/styled.pptx"

📦 Installation

Prerequisites

Pandoc Installation

# macOS
brew install pandoc

# Ubuntu/Debian
sudo apt-get install pandoc

# Windows
# Download from: https://pandoc.org/installing.html

UV Package Installation

# macOS
brew install uv

# Windows/Linux
pip install uv

Installation Options

Option 1: Manual Configuration

Add the following to your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-pandoc-md2pptx": {
      "command": "uvx",
      "args": ["mcp-pandoc-md2pptx"]
    }
  }
}

Option 2: Smithery (Automatic)

npx -y @smithery/cli install mcp-pandoc-md2pptx --client claude

📚 Documentation

Template Support

Create custom PowerPoint templates for consistent branding:

1. Generate the default template:

pandoc -o template.pptx --print-default-data-file reference.pptx

2. Customize it in PowerPoint with your preferred fonts, colors, and slide layouts.
3. Use it in the conversion:

"Convert content using /path/to/template.pptx as template"

🔧 Technical Details

Testing

uv run pytest

Building

uv sync
uv build

Publishing

uv publish

🤝 Contributing

1. Report Issues: GitHub Issues
2. Submit Pull Requests: Enhance the codebase or add new features.

🙏 Acknowledgement

Special thanks to MCP Pandoc and pandoc-ext/diagram

Simple, focused Markdown to PowerPoint conversion via MCP