A developer explains why they abandoned MkDocs for documentation sites and built their own static site generator called ddoc. The core frustration with MkDocs (and similar tools like Docusaurus, Sphinx, Jekyll) is that theme maintenance breaks over time — reinstalling requires fighting injected CSS and HTML structures you don't control. Zola was better but required too much template work for simple documentation needs. ddoc is a single binary with no dependencies that generates documentation sites from Markdown files, injects zero CSS or HTML layout, and is designed to remain stable across years and OS changes. It includes search out of the box and uses relative links throughout.
Table of contents
Why I had to give up with MkDocsAnother kind of solution: Zola (and similar)What I really wanted, what I madeThe experience you get with ddocSort: