3 ms·
Wow, what is up with the material mkdocs theme (https://squidfunk.github.io/mkdocs-material/ https://squidfunk.github.io/mkdocs-material/)? That's an extremely
by bccdee 3y ago
Wow, what is up with the material mkdocs theme (https://squidfunk.github.io/mkdocs-material/ 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.
- jonasdoesthings 3y agomkdocs-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.
- d4rkp4ttern 3y agoAt least for Python documentation, this plus mkdocstrings is great.
- d4rkp4ttern 3y agoCheck out the Pydantic docs pages - they use Mkdocs-material https://docs.pydantic.dev/latest/ https://docs.pydantic.dev/latest/