Markdown Slides is a skill that parses a Markdown file and converts it into a single, zero-dependency HTML5 presentation file. Slide boundaries are determined automatically by H2 headings or explicit horizontal rule separators (---), so no additional configuration is required to control slide structure.

The output is a self-contained HTML file with a high-contrast dark theme suited to code-heavy content. Navigation works via keyboard shortcuts (arrow keys, space bar), mouse-click advancement, and a full-screen presenter mode. A slide counter and a top-loading progress bar are included in the generated output.

Content rendering covers tables, blockquotes, syntax-highlighted code blocks, and images. Because the output is a single HTML file with no external dependencies, it can be opened in any browser without a build step or server.

The skill is aimed at developers who want to turn technical documentation, READMEs, or project notes into a presentable deck without switching to a separate slide-authoring tool or writing custom HTML, CSS, and navigation scripts. The structured conversion logic produces consistent formatting and layout on every run, avoiding the manual work of debugging CSS overflows or styling code blocks by hand. The resulting file is saved directly to the workspace.

Use cases

Convert a project README into a presentation deck for a team demo

Turn technical documentation into a self-contained HTML slideshow for a conference talk

Generate a slide deck from structured Markdown notes without writing any HTML

Produce syntax-highlighted code slides from existing code-walkthrough documents

Create a zero-dependency presentation file that can be shared as a single HTML file

When to use it

The source content is already written in Markdown and needs to become a slide deck

A self-contained, single-file HTML output with no build dependencies is required

The presentation contains code blocks that need syntax highlighting

Dark-theme, developer-oriented slide styling is acceptable or preferred

When not to use it

Branded or custom-themed slide decks are required, as the output uses a fixed dark theme

Output formats other than HTML are needed (e.g., PDF, PPTX, Google Slides)

Slides require complex animations or slide transitions beyond what a static HTML file provides

The agent workflow has no tool list defined, meaning there are no exposed tools to invoke