Markdown to HTML Slide Deck Converter
Turns a markdown talk split by --- into one offline HTML deck with clean slide breaks, hidden speaker notes, and a slide overflow check.
Before & after
Same prompt, same agent — the only difference is the skill.
I can help convert your markdown into slides. You'd typically use markdown syntax with some kind of delimiter to separate slides — like a separator line between slides. Different slide tools accept different markdown formats, so it depends on which tool you want to use. You could generate HTML slides, PowerPoint, Google Slides, or something like a web-based presentation tool. You'd want to keep each slide concise with just the key points. It might be helpful to know what you're presenting, who the audience is, and what tool you prefer to use. Do you have the markdown file ready? What's your target format?
MARKDOWN TO SLIDES CONVERSION INPUT FORMAT: Markdown with separator as slide delimiter # Slide 1 Title Content here. SEPARATOR # Slide 2 Title More content. OUTPUT: HTML presentation (reveal.js) Live in browser, speaker notes, PDF export FEATURES INCLUDED • Theme: Professional dark mode with accent color (teal) • Syntax highlighting for code blocks • Speaker notes (captured in markdown) • Slide transitions (fade between slides) • Print to PDF ready YOUR WORKFLOW 1. Paste markdown file 2. Confirm slide count (N slides detected) 3. Choose theme (Professional, Creative, Minimal, Academic) 4. Generate HTML deck 5. Open in browser, present or share CUSTOMIZATIONS • Logo on title slide: Paste image URL • Font: Choose from system fonts • Color scheme: Light/Dark/Custom • Speaker timer: On/Off TIMELINE: 2 min setup, 5 min customization, ready to present.
About this skill
You wrote your talk in markdown because it's fast. Then the converter split your YAML front matter into a slide, cut a code sample in half at its ---, showed your speaker notes to the audience, and let slide 6 run off the bottom of the screen. This skill splits your deck correctly, lays out each slide based on what's on it, and tells you which slides won't fit before you present.
What it does
- Splits slides with a scan that knows about code fences and front matter, so
---inside code blocks, YAML front matter, and setext headings never cause a wrong break - Picks a layout for each slide from its content: title, section divider, full image, code-focused, quote, or standard
- Finds speaker notes in reveal.js, Marp, Slidev, Pandoc, and Deckset syntax and keeps them hidden off the slide
- Flags overcrowded slides using concrete limits (bullets, words, code lines and columns, table size) and names the exact point to split each one
- Builds a single HTML file with no dependencies: keyboard and click navigation, deep links to each slide, scaling that keeps the 16:9 shape, and printing to PDF at one slide per page
- Can instead fix your markdown for Marp, Slidev, reveal.js, or Pandoc, or write a converter script you can rerun
What you get
A slide map with one row per slide showing its layout and any problems, a list of fixes to make before you present, and a complete deck.html that opens in any browser without internet.
Best for
Engineers, technical speakers, and teachers who write talks in markdown and want a deck that presents correctly the first time, without opening a slide editor.
SKILL.md preview
---
name: markdown-to-html-slide-deck
description: Converts a markdown deck with slides separated by --- into a single self-contained HTML presentation, or fixes it for Marp, Slidev, reveal.js, or Pandoc. It uses a fence-aware splitter, picks a layout per slide, pulls out speaker notes, and checks slides against a fit budget. Use when the user says "turn this markdown into slides", "make a deck from my talk.md", "convert my notes into a presentation", "my slides split in the wrong places", "my code block got cut into two slides", "the text runs off the bottom of the slide", "my speaker notes are showing on screen", or "I need an HTML deck I can present offline".
---
… (sign up to view the full skill)More development skills
View all Development skills →CodeTour Walkthrough File Builder
Writes a valid CodeTour .tour file for your repo: persona-targeted steps anchored to verified file paths and line numbers.
Code-Accurate Docs: Docstrings, JSDoc, OpenAPI Specs
Docstrings, JSDoc/TSDoc, OpenAPI specs, and quickstart guides written from your real code, covering error paths and edge cases.
Markdown to Single-File HTML (Docs, Reviews, Slides)
Turns markdown into one offline-safe HTML file laid out as a document, diff review, or slide deck, with a fidelity report.
Release Changelog from Commits and PRs
Turns a commit range or merged PRs into a release changelog with breaking changes, migration steps, and user-facing wording.