# Install mkdocs-material with Homebrew, apk, chocolatey, apt, dnf, pacman, Nix

Material Design theme for MkDocs. Version 9.7.7 via Homebrew; verified 2026-07-18. Also installable with debian: sudo apt install mkdocs-material.

## Install

```sh
sudo av install brew:mkdocs-material
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mkdocs-material
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add mkdocs-material
```

  Evidence: Alpine Linux edge package indexes: mkdocs-material from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install mkdocs-material
```

  Evidence: Debian stable package indexes: mkdocs-material from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install mkdocs-material
```

  Evidence: Fedora Rawhide package metadata: mkdocs-material from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- pacman (92%):

```sh
sudo pacman -S mkdocs-material
```

  Evidence: Arch Linux sync databases: mkdocs-material from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#mkdocs
```

  Evidence: nixpkgs package indexes: mkdocs from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

### Windows

- Chocolatey (92%):

```sh
choco install mkdocs-material
```

  Evidence: Chocolatey community package catalog: mkdocs-material from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','microsoft-windows-terminal'

## Package facts

- **Package key:** brew:mkdocs-material
- **Package manager:** Homebrew
- **Version:** 9.7.7
- **Source summary:** Material Design theme for MkDocs
- **Homepage:** <https://squidfunk.github.io/mkdocs-material/>
- **Last updated:** 2026-07-18T21:09:33Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- mkdocs (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 9.7.7
## Project history and usage

Material for MkDocs is the Python package and MkDocs theme maintained under Martin Donath's squidfunk project. The GitHub repository was created in 2016 and presents the package as a documentation framework built on top of MkDocs: authors write Markdown, configure MkDocs, and select the Material theme to get search, responsive navigation, localization, extensions, and a polished documentation UI without moving to a hosted documentation platform.

### Project history

The project became one of the central packages in the MkDocs ecosystem because it expanded the role of a theme into a batteries-included documentation layer. Its documentation and changelog describe feature milestones such as instant navigation, navigation tabs and sections, search configuration, social cards, blog support, tags, privacy-aware asset handling, and integrations for common Markdown extensions. Its adoption is visible both in GitHub metadata and in testimonial use by projects and organizations; the project homepage names FastAPI/Typer/SQLModel and Hummingbot Foundation as users of the theme for their public documentation.

### How it is used

In package-manager terms, mkdocs-material is slightly unusual because it installs an executable named mkdocs, the same command as the core MkDocs package. Homebrew records that mkdocs and mkdocs-material conflict for that reason, even though the package is conceptually a theme and plugin bundle layered on MkDocs rather than a replacement for the static site generator itself.

### Sources

- <https://api.github.com/repos/squidfunk/mkdocs-material>
- <https://formulae.brew.sh/api/formula/mkdocs-material.json>
- <https://github.com/squidfunk/mkdocs-material>
- <https://squidfunk.github.io/mkdocs-material/>
- <https://squidfunk.github.io/mkdocs-material/changelog/>
- <https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/>


## Security Notes

No matching local secret-handling manifest was found for mkdocs-material. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: mkdocs.yml
## Other Package-Manager Records

- Debian apt - mkdocs-material - 9.6.4-1: normalized package name match | Debian stable package indexes: mkdocs-material from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Material Design theme for MkDocs | https://squidfunk.github.io/mkdocs-material/
- Ubuntu apt - mkdocs-material - 9.4.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: mkdocs-material from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Material Design theme for MkDocs | https://squidfunk.github.io/mkdocs-material/
- apk - mkdocs-material - 9.5.5-r2: normalized package name match | Alpine Linux edge package indexes: mkdocs-material from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Material Design theme for MkDocs | https://squidfunk.github.io/mkdocs-material
- apk - mkdocs-material-pyc - 9.5.5-r2: normalized package name match | Alpine Linux edge package indexes: mkdocs-material-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for mkdocs-material | https://squidfunk.github.io/mkdocs-material
- dnf - mkdocs-material - 9.7.1-3.fc45~bootstrap: normalized package name match | Fedora Rawhide package metadata: mkdocs-material from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Material design theme for MkDocs | https://squidfunk.github.io/mkdocs-material
- dnf - mkdocs-material+imaging - 9.7.1-3.fc45~bootstrap: normalized package name match | Fedora Rawhide package metadata: mkdocs-material+imaging from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Metapackage for mkdocs-material: imaging extras | https://squidfunk.github.io/mkdocs-material
- pacman - mkdocs-material - 9.7.6-1: normalized package name match | Arch Linux sync databases: mkdocs-material from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Documentation that simply works | https://github.com/squidfunk/mkdocs-material
- Chocolatey - mkdocs-material: normalized package name match | Chocolatey community package catalog: mkdocs-material from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','microsoft-windows-terminal'
- Debian apt - mkdocs - 1.6.1+dfsg1-2: installed executable or alias match | Debian stable package indexes: mkdocs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Static site generator geared towards building project documentation | https://github.com/mkdocs/mkdocs
- Nix - mkdocs: installed executable or alias match | nixpkgs package indexes: mkdocs from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- Ubuntu apt - mkdocs - 1.5.3+dfsg-1: installed executable or alias match | Ubuntu 24.04 LTS package indexes: mkdocs from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Static site generator geared towards building project documentation | https://www.mkdocs.org/
- apk - mkdocs - 1.6.1-r1: installed executable or alias match | Alpine Linux edge package indexes: mkdocs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Project documentation with Markdown | https://www.mkdocs.org
- apk - mkdocs-pyc - 1.6.1-r1: installed executable or alias match | Alpine Linux edge package indexes: mkdocs-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for mkdocs | https://www.mkdocs.org
- dnf - mkdocs - 1.6.1-11.fc45: installed executable or alias match | Fedora Rawhide package metadata: mkdocs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Python tool to create HTML documentation from markdown sources | https://www.mkdocs.org
- pacman - mkdocs - 1.6.1-3: installed executable or alias match | Arch Linux sync databases: mkdocs from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Project documentation with Markdown | https://www.mkdocs.org
- Chocolatey - mkdocs: installed executable or alias match | Chocolatey community package catalog: mkdocs from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','microsoft-windows-terminal'


## Combined YAML source

View the package source record on GitHub. [combined/mkdocs-material.yml](https://github.com/mxcl/pkgdb/blob/main/combined/mkdocs-material.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph