MkDocs
Fewer than 5 people recommend it so far, so there's no written verdict. Here is what commenters said.
2recommend
7warn against
Nov 9, 2025first mention
Aug 28, 2026latest mention
Why people recommend it
“you can use MkDocs”
“I'm using mkdocs+material for one site (and it's great)”
Caveats and dissent
“Oh boy, no wonder MkDocs became an absolute shit-show that fucked everyone over”
Show 2 more
Often compared with
Threads where it came up
- Migrating to HTTPX2 2 mentions
- Our Continuation of MkDocs 2 mentions
- Zensical – A modern static site generator built by the Material for MkDocs team 2 mentions
- List of MkDocs Projects and Plugins 1 mention
- A practical guide for setting up Zettelkasten method in Obsidian 1 mention
- Ask HN: Best API Documentation Tools? 1 mention
Quotes are verbatim; the verdict and theme labels are written by a model from these comments, and every clause links to its sources.
All comments 12
“They also effectively killed off MkDocs”
“Oh boy, no wonder MkDocs became an absolute shit-show that fucked everyone over”
“The Slow Collapse of MkDocs”
Zensical has been a solid replacement for us so far. In general everything "just works" out of the box and is way quicker to build/reload. It is still in fairly early stages, but is actively being worked on https://zensical.org/spark/proposals/zap-005-navigation-authoring-experience/ I hope they are able to monetize in a way the keeps the core project open while making it a sustainable venture going forward.
“It feels misleading to describe it as a continuation of the existing project.”
“you can use MkDocs”
“I think it decide on mkdocs but it probably does not matter much.”
“More related drama: The Slow Collapse of MkDocs”
“well it looks like mkdocs is already dead”
“I can tell they're using MkDocs for the HyperDocs static site gen”
“with MkDocs using YAML, and Material for MkDocs being the main entrypoint for many of our users, we got a lot of issues”
“I'm using mkdocs+material for one site (and it's great)”