Misplaced Pages

MkDocs

Article snapshot taken from Wikipedia with creative commons attribution-sharealike license. Give it a read and then ask your questions in the chat. We can research this topic together.
Documentation generator
This article has multiple issues. Please help improve it or discuss these issues on the talk page. (Learn how and when to remove these messages)
The topic of this article may not meet Misplaced Pages's notability guidelines for products and services. Please help to demonstrate the notability of the topic by citing reliable secondary sources that are independent of the topic and provide significant coverage of it beyond a mere trivial mention. If notability cannot be shown, the article is likely to be merged, redirected, or deleted.
Find sources: "MkDocs" – news · newspapers · books · scholar · JSTOR (December 2023) (Learn how and when to remove this message)
This article may rely excessively on sources too closely associated with the subject, potentially preventing the article from being verifiable and neutral. Please help improve it by replacing them with more appropriate citations to reliable, independent, third-party sources. (December 2023) (Learn how and when to remove this message)
(Learn how and when to remove this message)
MkDocs
MkDocs Logo
Developer(s)Tom Christie, Dougal Matthews, Waylan Limberg, Oleh Prypin, Ultrabug
Initial releaseJanuary 24, 2014 (2014-01-24)
Stable release1.6.1 / August 30, 2024; 4 months ago (2024-08-30)
Repository
Written inPython
Operating systemCross-platform
TypeDocumentation generator
LicenseBSD
Websitewww.mkdocs.org

MkDocs is static site generator designed for building project documentation. It is written in Python, and also used in other environments.

Mode of operation

MkDocs converts Markdown files into HTML pages, effectively creating a static website containing documentation.

Markdown is extensible, and the MkDocs ecosystem exploits its extensible nature through a number of extensions that help with for autogenerating documentation from source code, adding admonitions, writing mathematical notation, inserting footnotes, highlighting source code etc.

Themes

MkDocs provides two built-in themes, default theme (based on Bootstrap) and Read the Docs theme. Many of the available third-party themes are listed in the official catalog, including the popular Material for MkDocs theme.

History

The first tagged version of MkDocs, version 0.2, came out on January 21, 2014.

By early 2015, Read the Docs supported building documentation with MkDocs, in addition to Sphinx. In preparation for the 0.12 release, MkDocs started using Read the Docs for hosting.

In January 2016, MkDocs added support for installable themes. Next month, Martin Donath started developing Material for MkDocs theme. In the following years, the theme became very popular and in July 2020 the development model was changed to sponsorware, where the new features get released to the Insiders version first and become publicly available after funding goals are hit.

Usage

MkDocs offers built-in support for deployment to GitHub Pages. Alternatives, such as GitLab and Cloudflare Pages, offer first-party support for deploying MkDocs sites.

Many companies use MkDocs with the Material theme to deploy their documentation, including Atlassian, Google, Microsoft, and Red Hat. It is also a popular choice among open source projects, such as Electron, Kubernetes, and WebKit.

See also

References

  1. "Release Notes". MkDocs.
  2. "Extensions — Python-Markdown 3.4.4 documentation". python-markdown.github.io. Retrieved 2023-09-23.
  3. "Pymdown Extensions - PyMdown Extensions Documentation". facelessuser.github.io. Retrieved 2023-09-23.
  4. Theming catalog, MkDocs, 2023-09-23, retrieved 2023-09-23
  5. Donath, Martin. "Material for MkDocs". squidfunk.github.io. Retrieved 2023-09-23.
  6. "Release 0.2 · mkdocs/mkdocs". GitHub. Retrieved 2023-09-24.
  7. "MkDocs 0.12 is in the wild. Lots of bug fixes and a few new features". X (formerly Twitter). 2015-04-14. Retrieved 2023-09-24.
  8. "mkdocs | Read the Docs". readthedocs.org. 2015-02-12. Retrieved 2023-09-24.
  9. "The new MkDocs release supports installable themes. Nice addition to the project that will let you install via pip". X (formerly Twitter). 2016-01-21. Retrieved 2023-09-24.
  10. Donath, Martin (2021-12-27). "The past, present and future - Material for MkDocs". squidfunk.github.io. Retrieved 2023-09-24.
  11. "GitLab Pages examples / mkdocs · GitLab". GitLab. Retrieved 2023-12-10.
  12. "Deploy an MkDocs site · Cloudflare Pages docs". developers.cloudflare.com. 2023-08-07. Retrieved 2023-12-10.
  13. "Atlassian DC Helm Charts". atlassian.github.io. Retrieved 2023-12-10.
  14. "Accompanist". google.github.io. Retrieved 2023-12-10.
  15. "Code With Engineering Playbook". microsoft.github.io. Retrieved 2023-12-10.
  16. "home - Ansible Lint Documentation". ansible-lint.readthedocs.io. Retrieved 2023-12-10.
  17. "electron-builder". www.electron.build. Retrieved 2023-12-10.
  18. "Welcome - kOps - Kubernetes Operations". kops.sigs.k8s.io. Retrieved 2023-12-10.
  19. "WebKit Documentation". docs.webkit.org. Retrieved 2023-12-10.

External links

  • MkDocs Edit this at Wikidata
  • Read the Docs large-scale, collaborative documentation host powered by Sphinx, MkDocs, and Jupyter Book
Categories: