Best Lightweight Docusaurus Alternative? I Think It’s "docmd" - A Refreshingly Minimal Docs Generator

Brian Sprout — Fri, 01 Aug 2025 22:12:31 +0000

I’ve tried just about every documentation generator out there. Some are great but heavy. Others are flexible but overwhelming.

Then I stumbled on docmd, and it was like a breath of fresh air.

It’s a tiny, Node.js-based static documentation generator that feels like the spiritual successor to the early days of Jekyll — but with modern DX.

And I cannot believe I didn’t find it earlier.

⚡ Why it’s different (and better)

npm install -g @mgks/docmd

cd docs
docmd init
docmd build

Zero setup: Just run a single command to scaffold
Install dependencies: Fast and light
Simple config: One file: config.js
Markdown-first: No weird templating. Just .md files.
Custom JS/CSS supported: Without hacks.
SEO + Analytics: Already handled with built-in plugins

I created a full-fledged docs site in 2 minutes.

✨ What impressed me most

The sidebar is just a JS array
The output is super clean (and mobile friendly)
It’s actually static, with no runtime JS bloat
You can inject your own code — I added a copy code button in 2 minutes

😅 The missing bits (for me atleast)

It’s not flawless — but here’s what I think it needs:

🔍 Search — nothing fancy, just Fuse.js or client-side index
🌙 Dark mode polish — code blocks don’t always follow the theme
📋 Copy code button — should be built-in, but you can add it via customJs These are totally reasonable gaps — and it’s so lightweight that I don’t mind extending it myself.

🛠 Features I want (and might contribute)

If you’re a contributor or forker, here are ideas worth adding:

Copy Code: true toggle in config
Search: true with options for Fuse.jsor Lunr
Better or improved theme switching for dark mode
Plugin auto-loading from a /plugins folder, might eradicate manually overlooking config more often

These would still keep docmd tiny — no React, no SPA overhead — but improve UX significantly.

🧭 Who it’s perfect for

Indie devs building tools and want fast docs
Internal documentation for startups
CLI/API reference sites
Anyone who hates maintaining Webpack-based doc setups

🌍 Help it grow

I honestly think more devs should know about docmd. It deserves way more visibility. It’s open-source, no lock-in, and solves the 80% use case beautifully.

If you're frustrated with heavy doc stacks — do yourself a favor and try it.

📎 Some Useful Links:

GitHub: https://github.com/mgks/docmd

Documentation: https://docmd.mgks.dev

NPM: https://www.npmjs.com/package/@mgks/docmd