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

Avatar photoByAdil

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

Similar Posts