Skip to main content

Project documentation with Markdown.

Project description

MkDocs

Project documentation with Markdown

PyPI Version Build Status Coverage Status

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.

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 build-in themes, third party themes or create your own.
  • Publish your documentation anywhere that static files can be served.
  • Much more!

Support

If you need help with MkDocs, do not hesitate to get in contact with us!

You can either open a Discussion to ask questions or create an Issue to report a bug or make a feature request. Please note that we may only provide support for problems/questions regarding core features of MkDocs. Any questions or bug reports about features of third-party themes, plugins, extensions or similar should be made to their respective projects.

Links

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 is expected to follow the PyPA Code of Conduct.

License

BSD-2-Clause

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs-1.2.1.tar.gz (6.3 MB view details)

Uploaded Source

Built Distribution

mkdocs-1.2.1-py3-none-any.whl (6.3 MB view details)

Uploaded Python 3

File details

Details for the file mkdocs-1.2.1.tar.gz.

File metadata

  • Download URL: mkdocs-1.2.1.tar.gz
  • Upload date:
  • Size: 6.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.8.10

File hashes

Hashes for mkdocs-1.2.1.tar.gz
Algorithm Hash digest
SHA256 6e0ea175366e3a50d334597b0bc042b8cebd512398cdd3f6f34842d0ef524905
MD5 12eb32c832661001e2f5e7b1dafd2aed
BLAKE2b-256 24194b8422c52fd0f34751c53785da6b7d27fff539f44128d0332fdb4694ba2b

See more details on using hashes here.

Provenance

File details

Details for the file mkdocs-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: mkdocs-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 6.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.8.10

File hashes

Hashes for mkdocs-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 11141126e5896dd9d279b3e4814eb488e409a0990fb638856255020406a8e2e7
MD5 cbeeaeafa91a9ae475007b1553ff5bb7
BLAKE2b-256 0761bdf4f713e78e0e058c75900b1d20bd09a2139f0b0526fef05634f50e3a0f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page