MkDocs NG

Write Markdown. Ship docs.
The maintained MkDocs that keeps your plugins working.

Documentation · Switching from MkDocs · Release notes · Plugin catalog

MkDocs is a fast, simple, and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown and configured with a single YAML configuration file. It is designed to be easy to use and can be extended with third-party themes, plugins, and Markdown extensions.

Clean build of the same 1,000-page site. Zensical is faster when it reuses its cache and when serve shows an edit.
How we measured

Note

MkDocs NG is a maintained fork of mkdocs/mkdocs, published on PyPI as mkdocs-ng while keeping the mkdocs command, imports and configuration unchanged — a drop-in replacement.

Highlights beyond the last upstream release: Python 3.10–3.15 support, built-in llms.txt and per-page Markdown output for LLMs and coding agents, search that finds programming keywords like while and for, faster builds with smaller site output, a stable Python API (mkdocs.build() / mkdocs.serve()), fully offline syntax highlighting with no CDNs or analytics, and many long-standing bug fixes — see Fixed Upstream Issues and the release notes, or browse all merged changes.

Please see the Documentation for an introductory tutorial and a full user guide.

Features

• Build static HTML files from Markdown files.
• Use Plugins and Markdown Extensions to enhance MkDocs.
• Use the built-in themes, third-party themes, or create your own.
• Publish your documentation anywhere that static files can be served.
• Much more!

Installation

Install with pip:

pip install mkdocs-ng

Switching from mkdocs? Just install MkDocs NG — the command, imports and configuration stay exactly the same:

pip install -U mkdocs-ng

Plugins and themes depend on the mkdocs package, so upstream MkDocs gets installed alongside. That's fine: MkDocs NG installs its files separately and always takes precedence, so leave the upstream package installed. See Plugins, themes and the mkdocs package for details, and Switching to MkDocs NG for what behaves differently from upstream MkDocs.

Support

If you need help with MkDocs:

• Use Discussions for questions and general help.
• To report a bug or make a feature request, open an Issue on GitHub.

We may only provide support for core MkDocs features. Questions about third-party themes, plugins, or extensions should usually go to those projects first, but they are still welcome in Discussions.

Links

• Official Documentation
• Latest Release Notes
• Fixed Upstream Issues
• Switching to MkDocs NG
• Comparison with upstream MkDocs 2.0, ProperDocs and Zensical
• Catalog of third-party plugins, themes and recipes
• Sumi, a local-first documentation theme from the MkDocs NG project
• MkDocs NG Material, Material for MkDocs maintained for MkDocs NG

Contributing to MkDocs

The MkDocs project welcomes and depends on contributions from developers and users in the open source community. Please see the Contributing Guide for information on how you can help.

Code of Conduct

Everyone interacting in the MkDocs project's codebases, issue trackers, and discussion forums are expected to follow the PyPA Code of Conduct.

License

BSD-2-Clause