mdBook review (2026): is it any good?
Command-line tool that builds books from Markdown
mdBook report card
Good · out of 4.0 · graded Nov 13, 2026
Best for books and manuals built from Markdown
mdBook is a command-line tool that builds a book from Markdown, with search, code highlighting and testing. It has no hosted editor, accounts or comments, and you host the output.
Who mdBook is for
- Fits if you write manuals or project guides in Markdown
- Works for Rust projects, as it's installed with Cargo
Who mdBook is not for
- Not for you if you avoid a command line, as that's the only way to use it
- Skip it if you want a hosted editor, as there are no accounts or comments
- Watch out: building from source needs a recent Rust version
- Watch out: you host the output yourself
Why mdBook gets a 2.6
Five grades, each with its reason. The GPA is their average: an A is 4 points, an F is none.
- AValue for moneyFree and open source under the Mozilla Public License v2.0; you pay only for the hosting. A program anyone can download and run is graded as free and substantial.
- AFree plan and trialFree outright, with no plan or cap. The only cost is wherever you host the output.
- CFeaturesMarkdown books, search, code highlighting and testing, themes and preprocessors. It builds books fully, and that is a small job.
- DEase of useIt's a developer tool run from the command line with files you write yourself. No store rating on record.
- CPlatforms and integrationsPrograms for Windows, macOS and Linux, which count as one device type. Output is a static site.
What these grades rest on. Graded from this listing, whose facts were read from mdBook's own pages on 13 November 2026. Not based on using the product, and shorter than our full reviews. How we review and grade.
Make mdBook? Put this grade on your site
Paste this where you want the badge. It links here and follows the grade if it changes. About badges
<a href="https://toolgpa.com/tools/mdbook#review"><img src="https://toolgpa.com/badge/mdbook.svg" alt="mdBook: 2.6 GPA on ToolGPA" width="196" height="56"></a>Where mdBook stands among docs and wiki tools
mdBook's GPA of 2.6 is higher than 47 of the 86 other docs and wiki tools we grade, and level with 17.
It stands best on free plan and trial (A, above 61 of 86) and worst on ease of use (D, above 0).
mdBook 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 87 docs and wiki tools we grade, cut by the letter each got. mdBook’s own letter is outlined.
- AValue for moneyAbove 60 of 86, level with 26
- AFree plan and trialAbove 61 of 86, level with 25
- CFeaturesAbove 2 of 86, level with 51
- DEase of useAbove 0 of 86, level with 24
- CPlatforms and integrationsAbove 0 of 86, level with 27
Price against what you get
Each dot is one of 79 docs and wiki tools. Further left costs less, and higher up scores better on features, ease of use and platforms. Point at a dot to see which tool it is.
Features, ease of use and platforms, averaged
What paid plans start at, a month (each step along is roughly double) →
- The best score at each price
- Has a free plan
- No free plan
Keep mdBook, or make your own?
Keep it
mdBook is free, so making your own would save you nothing.
And it is not the kind of software a weekend replaces.
What you could make
- Markdown and documents: an app builder makes these well.
What you could not
- Apps for macOS, Windows and Linux that stay in step with each other.
What this rests on. mdBook’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.
What is mdBook?
mdBook is a command-line tool, written in Rust, that creates books and documentation from Markdown files. The Rust project uses it for its own documentation. The source and documentation are released under the Mozilla Public License v2.0, and you host the generated output yourself.
Worth knowing
- It is a command-line tool with no hosted editor, accounts or comments.
- The installation page lists binaries for Windows, macOS and Linux, or building from source with a recent Rust version.
- You host the output yourself.
Key features
- Markdown books
- Content is written in Markdown and rendered as a book with a navigable table of contents.
- Integrated search
- Search is built in; the keyboard shortcut S or / opens it in the output.
- Code highlighting and testing
- Code blocks get syntax highlighting, and Rust code samples can be tested automatically.
- Themes
- Light, Rust, Coal, Navy and Ayu themes are included, and theme files allow custom formatting.
- Preprocessors and backends
- Preprocessors extend the syntax or change content, and built-in backends render HTML or Markdown.
mdBook pricing
As of Nov 13, 2026, mdBook is free to use.
- Starts at
- Free
- Free plan
- Free and open source under the Mozilla Public License v2.0; you pay only for wherever you host the output.
- Free trial
- None listed
| Plan | Price | What you get |
|---|---|---|
| Open source | $0 | Free under the Mozilla Public License v2.0. You build books with the mdbook command and host the output yourself. |
Read from rust-lang.github.io on Nov 13, 2026. Prices change, so confirm with mdBook before you buy.
Works with
- GitHub
- Cargo
mdBook alternatives
- mdBook vs MkDocs
Free
- mdBook vs Sphinx
Free
Common questions
Does mdBook have an Android app?
No Android app was listed when its pages were read on Nov 13, 2026. mdBook is listed for Windows, macOS and Linux.
Does mdBook have an iPhone app?
No iPhone app was listed when its pages were read on Nov 13, 2026. mdBook is listed for Windows, macOS and Linux.
Is mdBook open source?
Yes. mdBook is open source, according to its own site.
Sources for this page
The prices, plans, platforms and features above were read from these pages on Nov 13, 2026.