Quick tips Virtualenv pip install mkdocs pip install mkdocs-bootswatch Local testing mkdocs serve The local site will then be available by default at: http://localhost:8000 Publish to gh-pages mkdocs gh-deploy