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 built-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!

  • For questions and high-level discussions, use Discussions on GitHub.
    • For small questions, a good alternative is the Chat room on Gitter/Matrix (new!)
  • To report a bug or make a feature request, open an Issue on GitHub.

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.
But, such questions are not banned from the chat room.

Make sure to stick around to answer some questions as well!

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.4.tar.gz (6.3 MB view details)

Uploaded Source

Built Distribution

mkdocs-1.2.4-py3-none-any.whl (6.4 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mkdocs-1.2.4.tar.gz
  • Upload date:
  • Size: 6.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.13

File hashes

Hashes for mkdocs-1.2.4.tar.gz
Algorithm Hash digest
SHA256 8e7970a26183487fe2a1041940c6fd03aa0dbe5549e50c3e7194f565cb3c678a
MD5 72f0d956cf8cc795a891e5ebbd2ee154
BLAKE2b-256 d1a39e1d205738d4b09e634c5f1b9d8650bb45af0259f0eb0a945dfb555503b3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mkdocs-1.2.4-py3-none-any.whl
  • Upload date:
  • Size: 6.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.13

File hashes

Hashes for mkdocs-1.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f108e7ab5a7ed3e30826dbf82f37638f0d90d11161644616cc4f01a1e2ab3940
MD5 fd98509ea433b2bca4d354a0a1d27bd3
BLAKE2b-256 43e92ecb28b126c810585ea7c0a99c045cd5cd7be358d98dfa8a721c69276eb4

See more details on using hashes here.

Supported by

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