MkDocs
20 likes
MkDocs is 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.
License model
- Free • Open Source
Application types
Country of Origin
United Kingdom
Platforms
- Self-Hosted
- Python
Features
MkDocs News & Activities
Highlights All activities
Recent News
No news, maybe you know any news worth sharing?
Share a News TipRecent activities
ralaud added MkDocs as alternative to Quartz – Static Site Generator
SudoVanilla added MkDocs as alternative to ButterflyVu- bmyjacks rated MkDocs
- bmyjacks liked MkDocs
MkDocs information
Developed by
Tom Christie Licensing
Open Source (BSD-2-Clause) and Free product.Written in
Rating
Average rating of 3.6Alternatives
62 alternatives listedSupported Languages
AlternativeTo Category
DevelopmentGitHub repository
- 20,621 Stars
- 2,499 Forks
- 115 Open Issues
- Updated Feb 21, 2025
Comments and Reviews
So powerful while being simple, open, extensible and based on markdown.
Clunky documentation tool, supports the very old original markdown syntax not CommonMark (best) or GFM (okish). So writting doc is a nightmare as you don't have autolink without a plugin, you need to have exactly 4 spaces for lists (2 doesn't work) no table support, etc.
Also the dependencies are often breaking while installing, and the maintainer is stuborn and doesn't want any new features.
[Edited by alexandrezanni, September 01]
I would advice a tool I wrote, NextBook for you, literally one-click deployment. http://next-book.vercel.app/
Yay I tried it and it's a lot better.
I like mkdocs because its so easy to set up. However, if you're planning to use versioning — you'll have quite a bit of trouble as there is no native support for it and the extensions available are still in the 'workaround' state
Perfect online-wiki tool. Support all features that I can only wish as extensions.