Skip to content

material

Starting a blog with mkdocs-material on GitHub pages

After about a year since starting a blog with Jekyll on GitHub pages, the time has come to step this blog's game up. Jekyll is good, but it makes copying text a bit hard sometimes (hard to see) and code blocks are lacking some features like showing file names and highlighting specific lines. These features, and more, are available in Material for MkDocs, another Markdown-based documentation framwork that looks really good!

Get Started with Material for MkDocs

For a tutorial, see Material for MkDocs: Full Tutorial To Build And Deploy Your Docs Portal.

For more inspiration, see also Beautiful Pages on GitLab with mkdocs.