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

MkDocs plus Material theme on GitHub pages is pretty sweet. Automatic dark mode, useful plugins. I migrated from WordPress, no looking back.


Do you have an example link of a site running mkdocs with material theme?

Edit: I'm guessing it's this? https://squidfunk.github.io/mkdocs-material/getting-started/


yeah, that'd be the the one. Not too sure if mkdocs material is the best theme to go with for a blog, though.

Here's a site using it: https://docs.libretro.com/


I cut my teeth on Hugo and mdbook, and mkdocs was a breath of fresh air. No crazy templating, no pseudo-markdown index files, and lots of flexibility in the site and page structure.


Never heard of this but now I'm in love.

Now to figure out what I can write about.

Though I'm definitely going to use this for internal docs at work probably. Very nice.




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

Search: