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:
-
Extracted from upstream docs: https://raw.githubusercontent.com/squidfunk/mkdocs-material/HEAD/README.md