In this blog post, we’ll take a look at Jekyll to get a basic understanding how usage and setup works. We won’t use an existing template, we’ll follow the initial steps for implementation and then we configure the source code for a custom deployment to GitHub pages.
How to install MkDocs on Mac and setup the integration to GitHub pages?
This blog post contains the simplified steps to setup MkDocs for a GitHub project to use it with GitHub Pages. I won't covering details. The blog post is for me a little cheat sheet and maybe it is also useful for you. Steve Martinelli created an awesome blog post in that context called 5 Features I Like About Material for MkDoc.