Zero config docs in one command — now with interactive quizzes, LaTeX math, and agent skills that turn folders into courses and ebooks.
All the features of a professional docs platform, available in a
single npx command.
Point to any Markdown folder. No setup files, no build step, no scaffolding. mdsvr figures everything out.
npx mdsvr ./docs
# Done.
Render .md and .mdx with React
components — callouts, steps, tabs, cards, accordions.
Drop a ```quiz block into any page — exam or practice
mode, instant grading, score history. Self-checks built into your
docs.
Write $E = mc^2$ inline or ```math
blocks. GitHub-compatible LaTeX rendering — zero plugins.
Auto-detects OS preference. Fully customizable accent color. Theme toggle included.
Client-side search with ⌘K shortcut. Pre-built index. No Algolia account needed.
Sidebar and TOC auto-generated from your file structure. Active page highlighted. Collapsible sections.
Open Graph, Twitter Cards, JSON-LD, canonical URLs, OG image
generation, sitemap.xml, RSS, llms.txt.
Render flowcharts, sequence diagrams, ERDs from code blocks. Fullscreen, pan, zoom included.
Export to clean HTML for Firebase, Netlify, or GitHub Pages. Clean
URLs, no .html extensions.
Official Docker image on Docker Hub. Mount your docs folder and go.
docker pull ghcr.io/satoshiman/mdsvr:latest
Path traversal protection, hidden file blocking, sensitive extension filtering. Read-only by design.
mdsvr grew beyond serving files. Quizzes test what you learned, math renders beautifully, and everything lives in plain Markdown you own.
```quiz
{
"mode": "practice",
"questions": [{
"type": "single",
"question": "Which command serves a docs folder?",
"options": [
"npm run docs",
"npx mdsvr ./docs",
"mkdocs serve"
],
"answer": 1
}]
}
```The identity $e^{i\pi} + 1 = 0$
links five constants.
```math
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
```$...$, block $$...$$, or
```math fences — all LaTeX.
The identity links five constants.
Drop these components directly into your Markdown files — no imports, no setup.
npm install -g mdsvr
Install the bundled agent skills and your AI assistant (Devin, Windsurf, Claude Code…) becomes a learning companion — generating doc sites, personalized courses, and ebooks on demand.
markdown-for-mdsvrTurns any topic into a complete, multi-page doc site — correct mdsvr conventions, internal links, callouts, Mermaid, quizzes, and math baked in.
```quiz & ```math blocks
mdsvr-course-generatorSurveys the learner first — pace, depth, theory vs. practice — then generates a full course: lessons, labs, exercises, quizzes, and expert corners.
mdsvr-to-epubPackages any mdsvr doc set into a valid EPUB 3 ebook — cover, TOC, rendered Mermaid diagrams, math images, and quizzes as Q&A.
Every page ships the metadata a specialist would write by hand — generated automatically from your content, never invented.
summary_large_image
lastmod, noindex controls
llms-full.txt for AI crawlers
<title>Installation | My Docs</title>
<meta name="description"
content="Install mdsvr in one command…">
<link rel="canonical"
href="https://docs.example.com/install/">
<meta property="og:title" content="Installation">
<meta property="og:image"
content="…/assets/og/install/index.jpg">
<meta name="twitter:card"
content="summary_large_image">
<script type="application/ld+json">
{"@type":"Article","headline":"Installation",…}
</script>Every alternative requires setup. mdsvr doesn't.
| Feature | mdsvr | Docusaurus | Nextra | MkDocs | Hugo |
|---|---|---|---|---|---|
| Setup | ⚡ Zero config | Config required | Config required | YAML config | hugo.toml |
| Language | TypeScript / Node | Node + React | Next.js | Python | Go |
| MDX Support | ✓ Full | ✓ Full | ✓ Full | ✗ No | ✗ No |
| Dark Mode | ✓ Built-in | ✓ Built-in | ✓ Built-in | ✓ Built-in | ✓ Built-in |
| Search | ✓ Client-side | Algolia API | ✓ Client-side | ✓ Built-in | ✗ No |
| Mermaid | ✓ Yes | ✓ Yes | ✓ Yes | Plugin only | ✓ Yes |
| Static Export | ✓ Yes | ✓ Yes | ✓ Yes | ✓ Yes | ✓ Yes |
| Build Step | ✗ Not needed | Required | Required | Required | Required |
| Docker | ✓ Official image | DIY | DIY | DIY | DIY |
| Startup Time | 150ms | 8.5s build | 6.2s build | ~3s build | ~1s build |
| Interactive Quizzes | ✓ Built-in | ✗ No | ✗ No | ✗ No | ✗ No |
| LaTeX Math | ✓ Built-in | Plugin (remark-math) | ✓ Built-in | Plugin (Material) | Shortcode DIY |
| OG Images | ✓ Auto-generated | Manual | Manual | Manual | Manual |
| RSS + llms.txt | ✓ Built-in | Blog plugin only | ✗ No | Plugin | RSS only |
| EPUB Export | ✓ Via skill | ✗ No | ✗ No | ✗ No | ✗ No |
| AI Agent Skills | ✓ Bundled | ✗ No | ✗ No | ✗ No | ✗ No |
npx create-docusaurus@latest my-docs classicnpx mdsvr ./docs$ npx mdsvr ./docs$ npm install -g mdsvr
$ mdsvr ./docs$ npx mdsvr ./docs --init
# Creates _mdsvr/settings.json — customize title, theme, SEO...$ npx mdsvr ./docs --export
# Outputs to _html/public — deploy anywhere$ docker run -p 1800:1800 \
-v /path/to/docs:/app/docs \
ghcr.io/satoshiman/mdsvr:latestOther tools are built to be full frameworks. mdsvr is built to get out of your way.
No signup. No credit card. No configuration.
Just Markdown and
one command.
npx mdsvr ./docs