MkDocs Docker

Documentation that simply works

Demo

Demo

Docker

docker run -it --rm -v $PWD:/docs squidfunk/mkdocs-material new docs
docker run --rm -it -p 8000:8000 -v $PWD/docs:/docs squidfunk/mkdocs-material

http://localhost:8000/

Build documentation

docker run --rm -it -v $PWD:/docs squidfunk/mkdocs-material build

Deploy documentation to GitHub Pages

docker run --rm -it -v ~/.ssh:/root/.ssh -v $PWD:/docs squidfunk/mkdocs-material gh-deploy

Screenshots

More than just a static site

https://squidfunk.github.io/mkdocs-material/overrides/assets/images/spotlight/built-in-search.png

https://squidfunk.github.io/mkdocs-material/overrides/assets/images/spotlight/code-annotations.png

https://squidfunk.github.io/mkdocs-material/overrides/assets/images/spotlight/icons-emojis.png

References