The MkDocs Insider’s Guide
Everything we know about MkDocs in one document: what it costs, its grades, getting a refund, getting help and what else to look at. Read it here, or keep a copy.
MkDocs
The Insider’s Guide
Static site generator for Markdown project documentation
Every plan, grade, refund rule and rival among docs and wiki tools, read from MkDocs’s own pages.
Made by MkDocs Team · checked Nov 12, 2026 · toolgpa.com
Contents
- 01WelcomeWhat it is, who it suits, its grades and the ten things to know first
- 02What it costsEvery plan, the free plan, ways to pay less and how prices have moved
- 03What it doesIts main features, where it runs, what it works with and who makes it
- 04Where it standsIts grades against its category, and whether to keep it or make your own
- 05The alternativesThe tools it is most often weighed against, side by side
- 06Quick answersThe questions people ask about it, each answered in a line or two
- 07About ToolGPAWho made this guide, what else is on the site, and how to cite it
ToolGPA put this guide together from MkDocs’s own pages, its app-store listings and our grades. Every fact in it is on MkDocs’s page too, where it is kept up to date. Checked Nov 12, 2026.
Part 01 · Overview
Welcome
What it is, who it suits, its grades and the ten things to know first
2.6
GPA, above 38 of the 69 other docs and wiki tools we grade
MkDocs builds a documentation website from Markdown files and one YAML configuration file. It includes a development server that reloads as you edit, two built-in themes, and support for third-party themes and plugins. The output is static HTML that can be hosted anywhere.
To get you started, here are 8 things to know about MkDocs, taken from its own pages and our grades.
It does nothing else: no web editor, accounts or hosting, and many themes and features come from third-party plugins.
- 1
Best for a Markdown docs site built with Python
MkDocs is a free command-line tool that builds a docs site from Markdown, with a live preview and themes.
- 2
It is free
MkDocs has no paid plan at all. Free and open source under a BSD license; you pay only for wherever you host the output.
- 3
It runs on Web
Web.
- 4
Markdown source
Documentation is written in Markdown files and configured with a single YAML file.
- 5
Live preview server
A built-in development server auto-reloads the browser whenever a file changes.
- 6
Themes
Two themes, mkdocs and readthedocs, are built in; third-party themes are listed on the MkDocs wiki and catalog.
- 7
A 2.6 GPA, above 38 of 69
That is against the other docs and wiki tools we grade, on value, the free plan, features, ease of use and platforms.
- 8
Keep it
MkDocs is free, so making your own would save you nothing.
MkDocs at a glance
- Pricing
- Free
- Free plan
- Yes
- Free trial
- None stated
- Runs on
- Web
- Made by
- MkDocs Team
- Category
- Docs & Wikis
- Our grade
- 2.6 GPA, good
The report card
Best for a Markdown docs site built with Python
MkDocs is a free command-line tool that builds a docs site from Markdown, with a live preview and themes. It does nothing else: no web editor, accounts or hosting, and many themes and features come from third-party plugins.
| Subject | Grade | Comment |
|---|---|---|
| Value for money | A | Free and open source under a BSD license, a program anyone can download and run, with only the hosting of the output to pay for. That is under 60% of the category's cheapest quarter. |
| Free plan and trial | A | No plan, no caps. You pay only for wherever you host the built site, which can be free. |
| Features | C | Markdown source, a live preview server, themes, plugins and hosting anywhere. It does that one job fully, but it is a smaller job: it only builds, and features beyond the basics come from third-party plugins. |
| Ease of use | D | A command-line tool that needs a recent Python and its package manager, plus a config file to edit. |
| Platforms and integrations | C | Builds a web site from files. GitHub Pages and Amazon S3 are the hosting routes named, and there is no hosted service or app. |
An A is worth 4 points, a B 3, a C 2, a D 1 and an F nothing. The GPA is the average of the five.
Who MkDocs is for
- Fits if you are comfortable with Python and a terminal and want docs from Markdown files
- Works for a project that already hosts static files on GitHub Pages or S3
Who it is not for
- Not for you if you want a web editor, as it only builds a site
- Skip it if no one on the team can use a command line
- Watch out: many themes and extra features come from third-party plugins
- Too light for a team wiki, since there are no accounts, comments or hosting
Good to know
Good for
- Developers who want Markdown docs in a repository and a simple build
- Projects that already host static sites
Worth knowing
- It is a command-line tool that needs a recent Python and the Python package manager to install.
- It only builds a site: there is no web editor, accounts or hosting.
- Features beyond the basics, including many themes, come from third-party plugins.
Part 02 · Pricing
What it costs
Every plan, the free plan, ways to pay less and how prices have moved
Free
No paid plan at all
MkDocs is free to use.
Free and open source under a BSD license, a program anyone can download and run, with only the hosting of the output to pay for.
Open source
$0
Free and open source under a BSD license. You build the site with Python and host the output yourself.
The free plan
Free and open source under a BSD license; you pay only for wherever you host the output.
Read from mkdocs.org on Nov 12, 2026.
Part 03 · Features
What it does
Its main features, where it runs, what it works with and who makes it
1
Place it runs: Web
Static site generator for Markdown project documentation. Here is what it does, as its own site describes it, and what it covers: open source, Markdown, documents.
Markdown source, a live preview server, themes, plugins and hosting anywhere.
- Markdown source
- Documentation is written in Markdown files and configured with a single YAML file.
- Live preview server
- A built-in development server auto-reloads the browser whenever a file changes.
- Themes
- Two themes, mkdocs and readthedocs, are built in; third-party themes are listed on the MkDocs wiki and catalog.
- Plugins and extensions
- Plugins and Markdown extensions change how pages are built and rendered.
- Host anywhere
- The output is static HTML, which can go on GitHub Pages, Amazon S3 or any web host.
Where it runs
- Web
What it works with
- GitHub Pages
- Amazon S3
MkDocs is made by MkDocs Team.
Part 04 · Standing
Where it stands
Its grades against its category, and whether to keep it or make your own
38/69
Other docs and wiki tools it is graded above
MkDocs's GPA of 2.6 is higher than 38 of the 69 other docs and wiki tools we grade, and level with 10.
It stands best on free plan and trial (A, above 51 of 69) and worst on ease of use (D, above 0).
MkDocs has no paid plan.
On features, ease of use and platforms it scores 1.7 out of 4. Nothing scores higher for less, though at least one tool matches that score at a lower price.
Each grade against the category
Every bar is all 70 docs and wiki tools we grade, cut by the letter each got. MkDocs’s own letter is outlined.
- AValue for moneyAbove 50 of 69
- AFree plan and trialAbove 51 of 69
- CFeaturesAbove 2 of 69
- DEase of useAbove 0 of 69
- CPlatforms and integrationsAbove 0 of 69
Price against what you get
Each dot is one of 63 docs and wiki tools. Further left costs less; higher up scores better on features, ease of use and platforms. MkDocs is the marked dot.
What paid plans start at, a month (each step along is roughly double) →
Keep it, or make your own?
Whether this is something you could build for yourself with an AI app builder, and what you would give up.
Keep it
MkDocs is free, so making your own would save you nothing.
What you could make
- Documents and Markdown: an app builder makes these well.
What this rests on. MkDocs’s listing: what it does, where it runs, what it plugs into and what it costs. It is a judgement about the kind of software this is. We have not built a replacement for it, and making your own means looking after it too. How we decide, and every tool’s verdict.
Part 05 · Alternatives
The alternatives
The tools it is most often weighed against, side by side
Docusaurus, Sphinx, Read the Docs, GitBook and Gramax
The 5 tools MkDocs is most often weighed against, with where each one differs from it.
- 2.8GPA
Docusaurus
Free
- 2.6GPA
Sphinx
Free
Documentation generator for Python projects and beyond.
- Only MkDocs lists a web app.
- Only Sphinx lists macOS, Windows and Linux apps.
- 2.0GPA
Read the Docs
Free plan · from $50/mo
Hosts documentation built from a Git repository.
- MkDocs is open source, according to its own site.
- MkDocs also covers Markdown.
- 2.4GPA
GitBook
Free plan · from $65/mo
Documentation platform for product and API docs, synced with Git.
- MkDocs is open source, according to its own site.
- GitBook also covers AI search and AI agents.
- 3.0GPA
Gramax
Free plan · from $17/mo
Open-source knowledge base that stores Markdown in Git.
- Only Gramax lists macOS, Windows and Linux apps.
- Gramax is self-hostable, according to its own site.
- MkDocs also covers documents.
Part 06 · Questions
Quick answers
The questions people ask about it, each answered in a line or two
12
Questions, each answered in a line or two
The short version of everything above, for when you only need the answer. Each one is told in full in its part of the guide.
Is MkDocs free?
Yes. MkDocs is free to use.
How much does MkDocs cost?
MkDocs lists one plan. Open source: $0.
What platforms does MkDocs work on?
MkDocs is available on Web.
Does MkDocs have an Android app?
No Android app was listed when its pages were read on Nov 12, 2026. MkDocs is listed for Web.
Does MkDocs have an iPhone app?
No iPhone app was listed when its pages were read on Nov 12, 2026. MkDocs is listed for Web.
Is MkDocs open source?
Yes. MkDocs is open source, according to its own site.
What does MkDocs integrate with?
MkDocs's listing names GitHub Pages and Amazon S3. A listing names up to eight integrations, so it may connect to more.
Who makes MkDocs?
MkDocs is made by MkDocs Team.
What are the alternatives to MkDocs?
The closest alternatives to MkDocs in our directory are Docusaurus, Sphinx, Read the Docs, GitBook and Gramax.
How does MkDocs compare with other docs and wiki tools?
MkDocs's GPA of 2.6 is higher than 38 of the 69 other docs and wiki tools we grade, and level with 10.
Is MkDocs good value for money?
ToolGPA grades MkDocs A for value for money. MkDocs has no paid plan.
Could I make my own version of MkDocs?
MkDocs is free, so making your own would save you nothing. This is a judgement from its listing.
Where this guide comes from
The prices, plans, platforms and features were read from MkDocs’s own pages on Nov 12, 2026, and the grades were given on Nov 12, 2026. Graded from this listing, whose facts were read from MkDocs's own pages on 12 November 2026. Not based on using the product, and shorter than our full reviews.
Every tool we list gets five grades, A to F, each with its reason, and a GPA that averages them. How each is decided is at toolgpa.com/grades. This guide is ToolGPA’s own work; it is not made, paid for or approved by MkDocs Team. Prices change, so check mkdocs.org before you buy.
Part 07 · About
About ToolGPA
Who made this guide, what else is on the site, and how to cite it
5,038
Tools graded, in 95 categories
ToolGPA grades software the way a school report grades a pupil: five subjects, a letter for each with the reason written beside it, and a GPA that averages them. Prices, plans and platforms are read from each maker’s own pages and dated, so you always know how fresh a figure is.
Every grade, review and ranking on ToolGPA is our own judgement. No company can pay for a grade or change one. Every tool on the site has a guide like this one, free to download and pass on. It all lives at toolgpa.com.
5,038
tools graded
95
categories
739
price changes on record
579
apps priced in 12 countries
What else is on toolgpa.com
- MkDocs, kept up to dateEverything in this guide, with prices and grades as they are todaytoolgpa.com/tools/mkdocs
- How grades are givenThe rules behind every letter and every GPAtoolgpa.com/grades
- Value chartsWhat each tool costs against what it scores, for every categorytoolgpa.com/charts
- CompareAny two tools side by side, plan by plantoolgpa.com/compare
- Price changesEvery price rise and cut on record, each with its sourcetoolgpa.com/price-changes
- Prices by countryWhat apps cost on the App Store in 12 countriestoolgpa.com/prices-by-country
- Pay lessEvery public discount: yearly billing, students, nonprofitstoolgpa.com/save
- Keep or makeWhich tools are worth paying for, and which you could build yourselftoolgpa.com/keep-or-make
Scan for the live page
Prices and grades as they are today
Quoting this guide?
Please name ToolGPA and link to the live page, so readers can check the figures for themselves:
ToolGPA, "MkDocs: The Insider's Guide", checked Nov 12, 2026. https://toolgpa.com/tools/mkdocs
Know someone choosing between docs and wiki tools?
Send them this guide: toolgpa.com/tools/mkdocs/guide
ToolGPA elsewhere: youtube.com/@toolgpa
See our other guides
The best-graded docs and wiki tools after MkDocs, each with an Insider's Guide of its own.
- Docs & Wikis Insider's GuideEvery one of the 70 docs and wiki tools we grade, compared
- Zoho Writer Insider's GuideFree online word processor with AI and document automation3.6 GPA
- Google Docs Insider's GuideBrowser-based word processor, free with a Google Account3.4 GPA
- ONLYOFFICE Insider's GuideOpen-source office suite for documents, sheets, slides and PDFs3.4 GPA
Choosing software? Every tool graded, every price dated.
Compare tools at toolgpa.com ›Everything in this guide is ToolGPA’s own summary of what MkDocs’s pages, its app-store listings and public reviews said on the dates shown. Grades are our judgement under the rules at toolgpa.com/grades. Every grade, review and ranking on ToolGPA is our own judgement. No company can pay for a grade or change one. MkDocs is a trademark of its owner, and this guide is not made, paid for or approved by MkDocs Team. Prices and plans change: check mkdocs.org before you buy.