Chapter I

Documentation
should be
effortless

The open-source Mintlify alternative

SuperDocs is a modern documentation generator that combines the simplicity of zero-config tools with the power of Astro. Write in Markdown, ship as static HTML. Beautiful by default, customizable when needed.

"The best documentation tool is the one you'll actually use. Everything else is just friction."

— Design principle

Built on principles,
not compromises

Most documentation tools force you to choose between simplicity and power. Hosted platforms are easy but expensive. Custom builds are flexible but time-consuming.

SuperDocs refuses this false dichotomy. It's a CLI tool that generates static sites from Markdown, powered by Astro under the hood. Start with a simple JSON config. Customize with MDX when you need to. Eject to full Astro when you're ready.

Self-hosted. Open source. Free forever.

Zero to docs in seconds

Point SuperDocs at your Markdown files. Add a simple JSON config. Run one command. Your documentation site is ready.

$ npm install -g @devrohit06/superdocs
$ superdocs dev --input ./docs
✓ Dev server running at http://localhost:4321

Astro-powered performance

Built on Astro's cutting-edge architecture. Ship zero JavaScript by default. Optimal SEO. Lightning-fast page loads. Islands architecture when you need interactivity.

Progressive customization

Start with Markdown. Add MDX components when needed. Use the full Astro API. Or eject the entire project to customize every detail. Your choice at every step.

// In your .mdx file
import { MyComponent } from './components'
 
# My Documentation
 
<MyComponent />

OpenAPI integration

Generate beautiful API documentation from OpenAPI specs. Automatic endpoint pages. Type-safe examples. Interactive request builders.

Start writing,
not configuring