I'm working on a bigger Python project that I'll release soon, and as part of it I found myself needing a documentation site. Most doc sites are served statically, but every time I fall for the siren song of a static site I end up regretting it the moment I want some dynamic behaviour. So I figured I'd use my go-to, Django, and serve a proper docs site with that. As we say in Dutch: "Zo gezegd, zo gedaan"; roughly, "no sooner said than done".
So I took a small side quest from the larger project and built a decent docs engine for Django, called mdjango. Some notable features:
- Markdown based. Point it at a directory of .md files and mdjango handles the rest.
- Sensible default design. There are a few knobs for fonts, base colors and the like, but customization is deliberately limited. mdjango shouldn't have you tweaking endlessly. Set it up, adjust just enough to fit your style, and get on with your work.
- MiniSearch.js out of the box. Fast, client-side, typo-tolerant fuzzy search across your docs.
- LLM ready. llms.txt and llms-full.txt are generated automatically, so agents can consume your docs without any extra work.
The mdjango docs are themselves built with mdjango, so they double as a demo.
Hope you find my little side quest useful. Try it out and let me know what you think. It's v0.1.0 so expect some rough edges.
AI disclosure: mdjango was developed AI-assisted, supervised by me as a professional software engineer.
fluxmatix•1h ago
I'm working on a bigger Python project that I'll release soon, and as part of it I found myself needing a documentation site. Most doc sites are served statically, but every time I fall for the siren song of a static site I end up regretting it the moment I want some dynamic behaviour. So I figured I'd use my go-to, Django, and serve a proper docs site with that. As we say in Dutch: "Zo gezegd, zo gedaan"; roughly, "no sooner said than done".
So I took a small side quest from the larger project and built a decent docs engine for Django, called mdjango. Some notable features:
- Markdown based. Point it at a directory of .md files and mdjango handles the rest.
- Sensible default design. There are a few knobs for fonts, base colors and the like, but customization is deliberately limited. mdjango shouldn't have you tweaking endlessly. Set it up, adjust just enough to fit your style, and get on with your work.
- MiniSearch.js out of the box. Fast, client-side, typo-tolerant fuzzy search across your docs.
- LLM ready. llms.txt and llms-full.txt are generated automatically, so agents can consume your docs without any extra work.
The mdjango docs are themselves built with mdjango, so they double as a demo.
Hope you find my little side quest useful. Try it out and let me know what you think. It's v0.1.0 so expect some rough edges.
AI disclosure: mdjango was developed AI-assisted, supervised by me as a professional software engineer.