md2ppt

Convert Markdown files to PowerPoint presentations, with optional AI-powered refinement.

Requirements

This tool requires a LiteLLM proxy. Direct OpenAI/Anthropic API keys are not supported.

Installation

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Configuration

Copy .env.example to .env and configure your LiteLLM proxy:

cp .env.example .env

Set your proxy URL and API key in .env:

LITELLM_API_KEY=your-proxy-api-key
LITELLM_API_BASE=https://your-litellm-proxy.example.com

Usage

Basic conversion:

python md2ppt.py slides.md

Interactive mode (AI asks questions to refine your presentation):

python md2ppt.py slides.md -i

Specify output file:

python md2ppt.py slides.md -o presentation.pptx

Use a different model:

python md2ppt.py slides.md -i -m anthropic/claude-sonnet-4-5

Markdown Format

• # H1 headings create new slides
• ## H2 becomes a subtitle (if first element) or section header
• - or * for bullet points (nesting supported)
• Regular paragraphs become slide text

Example

# Welcome to md2ppt
## A Markdown to PowerPoint Converter

# Features

- Simple markdown syntax
- Automatic slide creation
- Bullet point support
  - Nested bullets work too
  - Up to 3 levels deep

# How It Works

## Headings Create Slides

- H1 (`#`) creates a new slide
- H2 (`##`) becomes a subtitle
- Bullet points become slide content

# Get Started

- Install dependencies: `pip install -r requirements.txt`
- Run: `python md2ppt.py your_file.md`
- Open the generated `.pptx` file