Markdown Slides

The presentation framework that thinks like you do

Stop wrestling with PowerPoint. Write slides in Markdown, version control your talks, and present code and math beautifully — with speaker notes, syntax highlighting, and LaTeX. Share a URL, not a USB drive.

What's included

• Markdown-driven slides — --- separates slides, -- separates fragments
• Speaker notes — Note: blocks visible only in presenter mode
• Auto slide numbering + timer in presenter view
• Syntax highlighting for code blocks — 200+ languages
• LaTeX math — KaTeX rendering for $E=mc^2$ inline and $$...$$ block
• Mermaid diagrams — flowcharts, sequence diagrams, class diagrams
• Embedded media — local videos, YouTube, Bilibili, audio
• Progressive reveals — fragment-style stepped builds
• PDF export — print-style for handouts
• Auto light/dark with accent colour customisation

Who it's for

• DevRel + speakers doing the conference circuit
• Lecturers maintaining course slide decks year-over-year
• Researchers presenting paper talks
• Tech leads giving technical-design walk-throughs

Why version-controlled slides

When you write slides in Markdown:

• Your talks are git-diffable
• AI tools can edit them (Hugo Chat reads frontmatter blocks)
• Your handouts are auto-generated from the same source
• You stop emailing talk-final-v3-actually-final.pptx to yourself

Pair with the Technical Blog template if you want to publish the post + slides + handout from the same Markdown source.