Project documentation with Markdown
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.
Note
mkdocs is a maintained fork of mkdocs/mkdocs, continued from the
1.7.0 line and published on PyPI as mkdocs-ng, while preserving the mkdocs CLI.
It adds support for Python 3.13 and 3.14, restores mkdocs serve --livereload,
improves strict link and anchor validation, ensures reliable cleanup on SIGTERM,
removes the unmaintained mergedeep dependency, and modernizes CI, dependencies,
release workflows and much more.
The project is actively maintained and continues to track modern Python, packaging, and documentation workflows.
Please see the Documentation for an introductory tutorial and a full user guide.
- 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!
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.
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.
Everyone interacting in the MkDocs project's codebases, issue trackers, and discussion forums are expected to follow the PyPA Code of Conduct.