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

Project documentation with Markdown. Version 1.6.1 via Homebrew; verified 2026-07-13. Also installable with debian: sudo apt install mkdocs.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mkdocs
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add mkdocs
```

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

- Debian apt (92%):

```sh
sudo apt install mkdocs
```

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

- dnf (92%):

```sh
sudo dnf install mkdocs
```

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

- 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

- pacman (92%):

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

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

### Windows

- Chocolatey (92%):

```sh
choco install mkdocs
```

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

## Package facts

- **Package key:** brew:mkdocs
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mkdocs>
- **Version:** 1.6.1
- **Source summary:** Project documentation with Markdown
- **Homepage:** <https://www.mkdocs.org/>
- **Repository:** <https://github.com/mkdocs/mkdocs>
- **Upstream docs:** <https://www.mkdocs.org/>
- **License:** BSD-2-Clause
- **Source archive:** <https://files.pythonhosted.org/packages/bc/c6/bbd4f061bd16b378247f12953ffcb04786a618ce5e904b8c5a01a0309061/mkdocs-1.6.1.tar.gz>
- **Last updated:** 2026-07-13T11:00:34Z
- **Generated:** 2026-07-25T07:20:51+00:00

## Executables

- mkdocs (cli)
- mkdocs (alias)

## Dependencies

- libyaml
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-25
- Package-manager version: 1.6.1
- Package-manager updated: 2026-07-13
- Local data: ok
- Upstream repository: https://www.mkdocs.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

MkDocs is a Python static site generator for project documentation. Its documentation credits Tom Christie in the 2014 copyright line and the MkDocs team as maintainers, while the public GitHub repository was created in January 2014. The project established a simple convention that became its niche: documentation lives as Markdown files, site settings live in a single mkdocs.yml file, and the mkdocs command builds a static HTML site or runs a local auto-reloading preview server.

### Project history

The tool grew around a small core with extension points rather than a large documentation platform. Its own README and site emphasize themes, plugins, and Python Markdown extensions; built-in and third-party themes handle presentation, plugins add indexing or generated content, and the output can be hosted anywhere static files are served. Release notes show the 1.0 release in 2018 and continued 1.x maintenance through 1.6.1 in 2024, including changes around local preview, drafts, translations, and strict-mode behavior.

### How it is used

MkDocs sits in package managers as the base documentation generator. It is packaged widely across Linux distributions, Homebrew, Chocolatey, and Nix, and Homebrew records a conflict with mkdocs-material because both packages install a mkdocs binary. GitHub metadata shows broad adoption for the repository, with tens of thousands of stars and many dependent projects, which fits its role as the common base beneath themes such as Material for MkDocs.

### Sources

- <https://api.github.com/repos/mkdocs/mkdocs>
- <https://formulae.brew.sh/api/formula/mkdocs.json>
- <https://github.com/mkdocs/mkdocs>
- <https://raw.githubusercontent.com/mkdocs/mkdocs/master/README.md>
- <https://www.mkdocs.org/>
- <https://www.mkdocs.org/about/release-notes/>
- <https://www.mkdocs.org/getting-started/>


## Security Notes

No matching local secret-handling manifest was found for mkdocs. 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mkdocs
- **Version Scheme:** 0
- **Revision:** 3
- **Conflicts With:** mkdocs-material
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - mkdocs - 1.6.1+dfsg1-2: normalized package name 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: normalized package name 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: normalized package name 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: normalized package name 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: normalized package name 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-10.fc45: normalized package name match | Fedora Rawhide package metadata: mkdocs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Python tool to create HTML documentation from markdown sources | https://www.mkdocs.org
- pacman - mkdocs - 1.6.1-3: normalized package name 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: normalized package name match | Chocolatey community package catalog: mkdocs from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','mirc'


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [docfx](https://www.automicvault.com/pkg/brew/docfx/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown, static-site-generator.
- [docmd](https://www.automicvault.com/pkg/brew/docmd/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown, static-site-generator.
- [mdbook](https://www.automicvault.com/pkg/brew/mdbook/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown, static-site-generator.
- [pelican](https://www.automicvault.com/pkg/brew/pelican/) - Shares av.db curated category or tags: cli, developer-tools, markdown, python, static-site-generator.
- [sphinx-doc](https://www.automicvault.com/pkg/brew/sphinx-doc/) - Shares av.db curated category or tags: cli, developer-tools, documentation, python, static-site-generator.
- [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [adr-tools](https://www.automicvault.com/pkg/brew/adr-tools/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [asciidoc](https://www.automicvault.com/pkg/brew/asciidoc/) - Shares av.db curated category or tags: cli, developer-tools, documentation, python.

## Combined YAML source

View the package source record on GitHub. [combined/mkdocs.yml](https://github.com/automic-vault/db/blob/main/combined/mkdocs.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
