markdown-to-slides

Convert Markdown documents into PPTX presentations with themes and aspect options.

7|1|Updated Oct 20, 2021
One-click install
npx skills add https://github.com/knishioka/machine-learning-workshop --skill markdown-to-slides
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-slides
Source: https://github.com/knishioka/machine-learning-workshop/tree/main/claude-skills/markdown-to-slides
Command: npx skills add https://github.com/knishioka/machine-learning-workshop --skill markdown-to-slides

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx, and includes scripts (resource) components.

What problem does it solve?

Markdown documents often take time to transform into presentation decks. This Skill converts Markdown files into PPTX presentations, speeding up slide creation and reducing manual formatting.

Core Features & Use Cases

  • Slide-based parsing: Recognizes headings, lists, code blocks, and images to generate slides.
  • Output customization: Supports themes and aspect ratios; can generate 16:9 or 4:3 PPTX.
  • Use Case: Turn a structured Markdown report into a ready-to-present deck in seconds.

Quick Start

Provide input.md and run the CLI to produce output.pptx; for example: python scripts/md2slides.py input.md output.pptx.

Frequently Asked Questions about markdown-to-slides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Markdown file into a PowerPoint presentation?

Convert Markdown to PowerPoint by running the CLI tool with your input file: python scripts/md2slides.py input.md output.pptx. The tool parses Markdown headings, lists, code blocks, and images to generate slides automatically.

What Markdown elements does the slide converter support?

The converter supports H1 and H2 headings for slide structure, bullet lists, bold and italic text, code blocks, and images. Use heading levels and slide separators to organize content into individual slides.

Can I customize the output format and aspect ratio of my presentation?

Yes. The tool supports theme and aspect ratio options, allowing you to generate presentations in 16:9 or 4:3 formats. Specify these options when running the CLI to match your presentation requirements.

Do I need to install dependencies to use this Markdown-to-slides tool?

Yes. The tool requires python-pptx, which handles PPTX file generation. Install it before running the converter to ensure valid PowerPoint output is produced.

What's the fastest way to turn a structured report into a presentation deck?

Structure your report as Markdown with clear headings and content blocks, then run the conversion CLI in one command. The tool generates a ready-to-present PPTX in seconds without manual formatting.

What happens if my Markdown file contains formatting the converter doesn't recognize?

The tool focuses on headings, lists, code blocks, images, and text formatting. Unrecognized elements may be skipped or rendered as plain text. Test your Markdown structure to ensure compatibility before generating the final deck.