mdslides

Markdown in, presentation out.

A deck that explains itself · June 11, 2026

One file is the deck

No slide objects. No drag handles. No .pptx.

Just one markdown file — every # heading starts a new slide.

You're reading slide two of the file that drew it.

Write a slide

Type markdown. Get a slide.

That block on the left? It renders as the slide on the right — live, as you save.

# Second slide
## with a subtitle

- a point
- another point
- ==the one that matters==

Bullets reveal themselves

Lists build one press at a time — no markup needed:

Open the slide and the heading fades in
Press → and this appears
Press again for the next idea
← steps back through them

Then add a held line with .

The lean subset

Only what slides actually need:

bold, italic, ~~strikethrough~~, highlight
lists, tables, blockquotes, images
inline code and fenced blocks
math, server-rendered

Key	Does
`→` `space`	next
`O`	overview
`F`	fullscreen

Code, properly lit

Fenced blocks are tokenized by Shiki — the same engine VS Code uses:

Drop a language after the fence and it just lights up.

export default {
  brand: { text: 'mdslides' },
  theme: 'angular',
  transition: 'fade',
};

Math that renders

Inline like $e^{i\pi} + 1 = 0$ , or a centered block:

KaTeX renders it server-side — no MathJax flash, fonts auto-bundled.

\int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi}

Present like you mean it

Key	Action
`→` `space` `PageDn`	next slide / reveal
`←` `PageUp`	back
`O`	overview grid — jump anywhere
`F`	fullscreen
`.`	black the screen
`?`	help

The URL hash tracks your slide, so #/3 deep-links straight here.

Then ship it

Three ways out, same one file:

Static HTML or PDF — no runtime, no account, no lock-in.

mdslides ./slides.md          # present (live-reload dev server)
mdslides build ./slides.md    # self-contained dist/ → host anywhere
mdslides export ./slides.md   # slides.pdf, one page per slide

Your turn

`npx @exor404/mdslides`

It asks for a name, scaffolds a starter deck, and opens it.

The next slide you make starts with #.