DEV Community

Cover image for Docmd: Markdown to Docs, No Bullshit Documentation Generator
Ghazi
Ghazi

Posted on

Docmd: Markdown to Docs, No Bullshit Documentation Generator

#opensource #node #markdown #webdev

Writing documentation shouldn’t require a framework, a theme system, and a master's in YAML. Markdown is simple. So the output should be too.

Docmd is a Node.js-based static site generator for documentation. It takes a folder of .md files and spits out a responsive HTML site — with themes, sidebars, nested components, the usual stuff — without touching React, Vue, or anything that thinks hydration is necessary to show text.

Why Docmd?

Here’s the reality:

  • Docusaurus is bloated.
  • MkDocs is Python-based.
  • Mintlify wants a subscription.
  • GitHub’s own markdown rendering is mid.

So I built something for developers who just want this:

npm install -g @mgks/docmd
docmd init
Enter fullscreen mode Exit fullscreen mode

That’s it. You get a working documentation site.

Features (aka what actually works):

  • Multiple themes (sky/ruby/retro)
  • Nested custom containers: :::tabs, :::card, :::steps, etc.
  • Sidebar config, breadcrumb, favicon, metadata, theme-modes
  • GitHub Pages support
  • Local dev server (docmd dev)
  • Zero client-side JS frameworks (no React, no Bootstrap, no clutter)
  • Built-in plugins (SEO, sitemap, GA)
  • Pure markdown + YAML frontmatter - no templating drama

Built For People Who:

  • Write code, not content for marketing
  • Prefer folders over CMSes
  • Want to deploy docs to GitHub Pages without 30 extra steps
  • Hate “init” scripts that install 200MB of dependencies

Not For:

  • People who want live search, Algolia (sorry dev.to team), or page transitions
  • Anyone emotionally attached to React
  • Marketing teams with a Figma addiction

Try docmd

🔗 docmd.mgks.dev
📦 @mgks/docmd
🔧 github.com/mgks/docmd

No setup wizard. No plugins just to get tabs. No weird templating syntax.

Just markdown in → docs out.

That’s the whole pitch.

Top comments (0)