Markdown to HTML slides

Markdown in, one HTML deck out.

A command-line tool for developers and technical speakers who write talks in Markdown and want a single file they can present from anywhere.

$ npx mdslides talk.md -o talk.html

View on GitHub See the commands

talk.md ## Code, highlighted at build time ```ts export function greet(...) ```

Code, highlighted at build time

export function greet(name: string): string {
  return `Hello, ${name}!`;
}

Fenced blocks ship as static colored spans, no runtime.

3 / 6

Built for one job, done cleanly.

One file, nothing attached

Theme CSS, navigation JS, and local images are inlined as data URIs. The output is a single .html file with no sidecar folder to ship.

Your talk stays in git

Plain Markdown in, diffable line by line. A --- splits slides,  holds speaker notes, and code blocks are highlighted for you.

Present anywhere, offline

Open it in any browser with no server and no network. Arrow keys and click navigate; print to PDF with headless Chrome when you need a handout.

From file to deck in one command

$ npx mdslides talk.md -o talk.html --theme dark
Wrote talk.html

# pick a theme, add a progress bar, rebuild on save
$ mdslides talk.md --theme minimal --progress --watch

# themes: default | dark | minimal   ·   --css layers your own
# --no-counter hides the slide count   ·   -V prints the version