Best Lightweight Docusaurus Alternative? I Think It’s “docmd” – A Refreshingly Minimal Docs Generator

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:

1. 🔍 Search — nothing fancy, just Fuse.js or client-side index
2. 🌙 Dark mode polish — code blocks don’t always follow the theme
3. 📋 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