Hacker News new | ask | show | jobs
by jonasdoesthings 1086 days ago
mkdocs-materials is underselling itself as only a theme imo. It bundles a lot of value that mkdocs is missing out of the box as plugins and tweaks, like a good client-side search, page tags, or easy support for a lot of markdown extensions (e.g. code syntax highlighting, admonitions/callouts).

From my personal experience mkdocs+mkdocs-material is like GNU+Linux.

1 comments

At least for Python documentation, this plus mkdocstrings is great.