markdown-slides

Transform Markdown into Professional Slides

Stop wasting time with PowerPoint or complex build chains. The markdown-slides skill instantly converts any Markdown file into a sleek, self-contained HTML5 presentation. It is designed for developers who want to turn their technical documentation, READMEs, or project notes into polished decks without leaving their IDE.

What it does

This skill parses your Markdown and intelligently splits it into slides based on H2 headings or explicit horizontal rule (---) separators. It generates a single, zero-dependency HTML file featuring:

• Developer-First Design: A high-contrast dark theme optimized for readability and code blocks.
• Interactive Navigation: Keyboard shortcuts (Arrows, Space), mouse-click advancement, and full-screen presenter mode.
• Visual Cues: Dynamic slide counters and a top-loading progress bar.
• Rich Content Support: Renders tables, blockquotes, syntax-highlighted code blocks, and images perfectly.

Why use this skill

While you could prompt an AI to "write some HTML for slides," this skill uses a structured logic engine to ensure consistent formatting, proper slide-splitting, and a standardized layout every time. It eliminates the manual work of styling, writing navigation scripts, and debugging layout overflows in CSS. The result is a production-ready deck in seconds, saved directly to your workspace.