Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Wow, what is up with the material mkdocs theme (https://squidfunk.github.io/mkdocs-material/)? That's an extremely spiffy landing page, especially given that it's for a theme designed for a totally separate piece of software.


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.


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


Check out the Pydantic docs pages - they use Mkdocs-material

https://docs.pydantic.dev/latest/




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: