head to head · open source
mkdocs-material vs readme-ai
mkdocs-material has 27,596 GitHub stars, 4,154 forks, 1 open issues and last shipped 6 days ago. readme-ai has 3,005 stars, 296 forks, 57 open issues and last shipped yesterday. mkdocs-material leads on adoption by 818% (27,596 vs 3,005 stars). mkdocs-material is written in Python under MIT; readme-ai is written in Python under MIT. mkdocs-material has attracted 15% as many forks as stars, readme-ai 10%. readme-ai was the more recently maintained of the two, and both are self-hostable with no licence fee. The two share 1 topic tag (documentation), so they are genuine substitutes rather than adjacent tools.
Two open source projects, one decision. Both are free and self-hostable — the differences are community size, license terms, language stack and release pace.
← all 20902 open source comparisons
Side by side
| mkdocs-material | readme-ai | |
|---|---|---|
| GitHub stars | ★ 28K | ★ 3.0K |
| License | MIT | MIT |
| Written in | Python | Python |
| Last push | 2026-10-30 | 2026-11-04 |
| Forks | ⑂ 4.2K | ⑂ 296 |
| Self-hosting | Yes | Yes |
| Data ownership | Your server | Your server |
pick mkdocs-material if
- You weight community size — 28K stars and counting
- You want the MIT license terms
- Your stack matches Python
- You value the larger contributor base for long-term maintenance
pick readme-ai if
- You want the readme-ai feature set and don't need the biggest community
- You prefer the MIT license terms
- Your stack matches Python
- You evaluated both and readme-ai fits your workflow better
About mkdocs-material
A powerful documentation framework on top of MkDocs Write your documentation in Markdown and create a professional static site for your Open Source or commercial project in minutes – searchable, customizable, more than 60 languages, for all devices. Check out the demo – squidfunk.github.io/mkdocs material . Silver sponsors Bronze sponsors <img src=" height="58"
read the full mkdocs-material overview →
About readme-ai
Designed for simplicity, customization, and developer productivity. The metrics above are rendered with HyperWeave — an experimental SVG artifact layer for agents. Explore → Quick Links Intro Demo Features Quickstart Configuration Example Gallery Contributing Guidelines [!IMPORTANT] Explore the [Official Documentation][docs] for a complete list of features, customization options, and examples. Introduction ReadmeAI is a developer tool that automatically generates README files using a robust repository processing engine and advanced language models. Simply provide a URL or path to your codebase, and a well…
read the full readme-ai overview →
More in Content & Publishing
Related comparisons
More Documentation & Knowledge Base projects
Compare either of these against the rest of the Documentation & Knowledge Base field.
Frequently asked questions
Is mkdocs-material or readme-ai more popular?
mkdocs-material has 27,596 GitHub stars and readme-ai has 3,005. mkdocs-material has the larger community by that measure.
Are mkdocs-material and readme-ai free?
Both are open source. mkdocs-material is licensed under MIT and readme-ai under MIT. Neither carries a licence fee.
What is the difference between mkdocs-material and readme-ai?
mkdocs-material is written in Python and readme-ai in Python. The practical differences are community size, licence terms, language stack and release cadence — all compared in the table above.
Which should I choose, mkdocs-material or readme-ai?
Choose mkdocs-material if you want the larger community (27,596 stars) or its MIT licence terms. Choose readme-ai if its feature set, stack or MIT licence fits better. Both are self-hostable.