What is MkDocs?
It builds completely static HTML sites that you can host on GitHub pages, Amazon S3, or anywhere else you choose. There's a stack of good looking themes available. The built-in dev-server allows you to preview your documentation as you're writing it. It will even auto-reload and refresh your browser whenever you save your changes.
MkDocs is a tool in the Search Engines category of a tech stack.
Who uses MkDocs?
Companies
24 companies reportedly use MkDocs in their tech stacks, including SMARTTechStack, Toucan Toco, and docbox.
Developers
95 developers on StackShare have stated that they use MkDocs.
MkDocs Integrations
Pros of MkDocs
5
4
3
2
Decisions about MkDocs
Here are some stack decisions, common use cases and reviews by companies and developers who chose MkDocs in their tech stack.
Nikolaj Ivancic
at Congral · | 12 upvotes · 339.3K views
I want to build a documentation tool - functionally equivalent to MkDocs. The initial choice ought to be VuePress - but I know of at least one respectable developer who started with VuePress and switched to Nuxt.js. A rich set of "themes" is a plus and all documents ought to be in Markdown.
Any opinions?
MkDocs Alternatives & Comparisons
What are some alternatives to MkDocs?
Sphinx
It lets you either batch index and search data stored in an SQL database, NoSQL storage, or just files quickly and easily — or index and search data on the fly, working with it pretty much as with a database server.
Gitbook
It is a modern documentation platform where teams can document everything from products, to APIs and internal knowledge-bases. It is a place to think and track ideas for you & your team.
Jekyll
Think of Jekyll as a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages, which you can use to host sites right from your GitHub repositories.
Docsify
Docsify generates your documentation website on the fly without generating static html files. Instead, it loads and parses your Markdown files and displays them as a website.
Hugo
Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full html website. Hugo makes use of markdown files with front matter for meta data.
