Present from Markdown.
No slide software. No export step.
Write your design docs, runbooks, and team updates in plain Markdown. Run one command, and it becomes a responsive, keyboard-navigable slide deck in your browser that live-reloads on save.
curl -fsSL https://raw.githubusercontent.com/SXsid/mdslides/main/install.sh | bash
Production Architecture Overview
Welcome to mdslides. This live interactive simulator shows how plain Markdown documents render in the browser viewer.
Every # heading starts a new slide. Standalone images automatically trigger split or bento layouts without writing CSS or adjusting coordinates.
1 Image • Split 2-Column Layout
Automatic Bento-4 Image Grid
Four images on consecutive lines assemble into a balanced 2x2 bento grid with text captioning:
Native Mermaid.js Diagrams
Fenced code blocks with mermaid render as crisp vector graphics instead of raw text.
State machines, flowcharts, sequence diagrams, and class diagrams adapt automatically to the active presentation theme.
↓
[goldmark AST Walk]
↓
[Layout Engine Classify]
↓
[Render HTML + ES Modules]
Real-Time Live Reload via SSE
Save your Markdown file in VS Code, Vim, Helix, or Emacs, and the browser view reloads instantly.
Driven by an internal filesystem watcher and Server-Sent Events stream compiled directly into the single Go binary.
• Directory watcher active
• Zero cache invalidation required
Built for technical authors and teams
Intelligent Layout Classification
One image sits beside your text. Two stack vertically. Three arrange into a bento composition, and four become a balanced 2x2 grid. More than four flow cleanly into continuation screens under the same heading without overcrowding the viewport.
Real-Time Live Reload
Built-in directory watcher pushes change events through Server-Sent Events. The moment you hit save in your text editor, connected browsers refresh automatically.
Single Static Binary
All HTML templates, CSS styles, and ES modules are embedded directly into the executable via Go embed. No npm, no external bundlers, no runtime installations.
Native Mermaid Diagrams
Write flowchart and sequence diagram fences directly in Markdown. mdslides renders them as scalable vector graphics matching your active presentation theme.
GitHub-Flavored Markdown
Full support for tables, task lists, blockquotes, inline code, and syntax-formatted code fences right out of the box.
Plain Markdown in. Presentation deck out.
# Distributed Consensus We transitioned our primary replication protocol from two-phase commit to Raft. - Predictable leader election - Unified membership changes - Zero data drift on partitions  --- # Verification Benchmark | Metric | 2PC | Raft | |---|---|---| | Latency p99 | 142ms | 18ms | | Failover | 12s | 350ms |
Distributed Consensus
We transitioned our primary replication protocol from two-phase commit to Raft.
- Predictable leader election
- Unified membership changes
- Zero data drift on partitions