Build versioned technical docs sites with search and navigation using Material for MkDocs
Use Material for MkDocs to turn Markdown documentation into a searchable, navigable static site with project-ready configuration and previews.
Prerequisites
Python, pip or Docker, MkDocs, Material for MkDocs, Markdown documentation files
Installation
Use the upstream install or setup path that matches your environment:
- Make it yours – change the colors, fonts, language, icons, logo, and more with
- pip install mkdocs-material
Requirements and caveats from upstream:
- alt="Python Package Index"
- <img
- src="https://img.shields.io/docker/pulls/squidfunk/mkdocs-material"
Basic usage or getting-started notes:
Material for MkDocs can be installed with pip:
sh
Add the following lines to mkdocs.yml:
Source: https://github.com/squidfunk/mkdocs-material
Extracted from upstream docs: https://raw.githubusercontent.com/squidfunk/mkdocs-material/HEAD/README.md
Documentation
- https://squidfunk.github.io/mkdocs-material/