# Fumadocs vs MkDocs

| Attribute | Fumadocs | MkDocs |
|---|---|---|
| **vioscaleAI score** | 55.4 (57% (medium)) | 57.4 (71% (medium)) |
| activity.commits_last_30d | 100 | 0 |
| adoption.dependent_repos | 0 | 18,004 |
| adoption.github_stars | 13,360 | 22,497 |
| adoption.package_downloads_weekly | 2,167,532 | 3,612,213 |
| content.faq | `[{"answer":"A developer-focused documentation framework built on React, supporting Markdown and MDX authoring with customizable themes, OpenAPI integration for API documentation, and component showcase capabilities. It is indexed under Documentation Tools.","source":"https://fumadocs.dev","question":"What is Fumadocs?","confidence":0.6},{"answer":"Fumadocs supports the web and a command-line interface. Platforms we have not confirmed are simply not listed here rather than ruled out.","source":"https://fumadocs.dev","question":"What platforms does Fumadocs support?","confidence":0.6},{"answer":"Yes. Fumadocs can be deployed cloud / SaaS and self-hosted, so it does not have to run on the vendor's infrastructure.","source":"https://fumadocs.dev","question":"Can Fumadocs be self-hosted?","confidence":0.6},{"answer":"We have confirmed 10 integrations for Fumadocs, including OpenAPI, AsyncAPI, GraphQL, Next.js, Astro, React Router, Tanstack Start and Waku, plus 2 more. This is what we could verify from public sources, so the vendor may support others we have not indexed.","source":"https://fumadocs.dev","question":"What does Fumadocs integrate with?","confidence":0.6},{"answer":"Yes. Fumadocs is published under the MIT licence, a permissive licence that generally allows commercial use and modification. Licence terms can change between releases, so verify against the repository for the version you intend to use.","source":"https://github.com/fuma-nama/fumadocs","question":"Is Fumadocs open source?","confidence":0.99}]` | `[{"answer":"A documentation platform that converts Markdown files into static HTML websites. It offers built-in themes, plugin support for extensions, and YAML-based configuration for easy customization. It is indexed under Documentation Tools.","source":"https://www.mkdocs.org","question":"What is MkDocs?","confidence":0.6},{"answer":"MkDocs is open source, so it can be self-hosted and used at no licence cost. It is released under the BSD-2-Clause licence. Pricing changes often, so verify at source before relying on it.","source":"https://www.mkdocs.org","question":"Is MkDocs free to use?","confidence":0.6},{"answer":"MkDocs supports the web and a command-line interface. Platforms we have not confirmed are simply not listed here rather than ruled out.","source":"https://www.mkdocs.org","question":"What platforms does MkDocs support?","confidence":0.6},{"answer":"Yes. MkDocs can be deployed cloud / SaaS and self-hosted, so it does not have to run on the vendor's infrastructure.","source":"https://www.mkdocs.org","question":"Can MkDocs be self-hosted?","confidence":0.6},{"answer":"Yes. MkDocs is published under the BSD-2-Clause licence, a permissive licence that generally allows commercial use and modification. Licence terms can change between releases, so verify against the repository for the version you intend to use.","source":"https://github.com/mkdocs/mkdocs","question":"Is MkDocs open source?","confidence":0.67}]` |
| deployment.options | `{"cloud":true,"self_hosted":true}` | `{"self_hosted":true}` |
| description.long | A React-based documentation framework supporting Markdown and MDX, featuring customizable themes, a headless architecture for custom UI, OpenAPI integration for API documentation, and compatibility with various content sources. | A documentation platform that converts Markdown files into static HTML websites. It offers built-in themes, plugin support for extensions, and YAML-based configuration for easy customization. |
| features.capabilities | `{"kind":"static_generator","engine":"React","search":"algolia","authoring":"mdx","themeable":true,"api_reference":true,"self_hostable":true,"hosted_offering":false}` | `{"i18n":true,"kind":"static_generator","engine":"Python","authoring":"markdown","themeable":true,"build_model":"fully_static","api_reference":true,"self_hostable":true,"hosted_offering":false,"docs_specialised":true}` |
| integrations.count | 9 | - |
| integrations.list | `[{"name":"OpenAPI"},{"name":"AsyncAPI"},{"name":"GraphQL"},{"name":"Next.js"},{"name":"Astro"},{"name":"React Router"},{"name":"Tanstack Start"},{"name":"Waku"},{"name":"Algolia Search"},{"name":"Orama Search"},{"name":"content-collections","native":true},{"name":"contentlayer","native":true},{"name":"Content Collections","native":false}]` | - |
| language.primary | TypeScript | Python |
| license.spdx | MIT | BSD-2-Clause |
| platform.support | `{"cli":true,"web":true}` | `{"cli":true}` |
| pricing | - | `{"type":"open_source","freeTier":true,"sourceUrl":"https://www.mkdocs.org","retrievedAt":"2026-10-13T15:11:13.960Z"}` |
| pricing.free_tier | - | yes |
| pricing.model | - | open_source |
| pricing.price_level | - | free |
| pricing.transparent | - | yes |
| release.cadence_days | - | 77 |
| release.history | `[{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs%4016.17.3","date":"2026-10-14T06:13:06Z","type":"stable","version":"fumadocs@16.17.3"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/cli%4016.2.20","date":"2026-10-14T06:13:06Z","type":"stable","version":"cli@16.2.20"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/%40fumadocs/language%400.2.13","date":"2026-10-14T06:13:06Z","type":"stable","version":"@fumadocs/language@0.2.13"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs%4016.17.2","date":"2026-10-13T09:45:31Z","type":"stable","version":"fumadocs@16.17.2"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-openapi%4012.4.2","date":"2026-10-13T09:45:31Z","type":"stable","version":"fumadocs-openapi@12.4.2"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/cli%4016.2.19","date":"2026-10-13T09:45:31Z","type":"stable","version":"cli@16.2.19"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/%40fumadocs/story%401.5.0","date":"2026-10-13T09:45:31Z","type":"stable","version":"@fumadocs/story@1.5.0"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/%40fumadocs/language%400.2.12","date":"2026-10-13T09:45:31Z","type":"stable","version":"@fumadocs/language@0.2.12"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-typescript%405.5.2","date":"2026-10-12T16:26:00Z","type":"stable","version":"fumadocs-typescript@5.5.2"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/%40fumadocs/satteri%400.6.1","date":"2026-10-12T16:26:00Z","type":"stable","version":"@fumadocs/satteri@0.6.1"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/%40fumadocs/changelog%400.1.0","date":"2026-10-12T16:26:00Z","type":"stable","version":"@fumadocs/changelog@0.1.0"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs%4016.17.1","date":"2026-10-09T13:44:25Z","type":"stable","version":"fumadocs@16.17.1"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs%4016.17.0","date":"2026-10-09T10:08:15Z","type":"stable","version":"fumadocs@16.17.0"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-typescript%405.5.1","date":"2026-10-09T13:44:25Z","type":"stable","version":"fumadocs-typescript@5.5.1"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-typescript%405.5.0","date":"2026-10-09T10:08:17Z","type":"stable","version":"fumadocs-typescript@5.5.0"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-twoslash%404.0.2","date":"2026-10-09T10:08:17Z","type":"stable","version":"fumadocs-twoslash@4.0.2"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-python%401.0.4","date":"2026-10-09T10:08:16Z","type":"stable","version":"fumadocs-python@1.0.4"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-openapi%4012.4.1","date":"2026-10-09T12:07:04Z","type":"stable","version":"fumadocs-openapi@12.4.1"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-openapi%4012.4.0","date":"2026-10-09T10:08:16Z","type":"stable","version":"fumadocs-openapi@12.4.0"},{"url":"https://github.com/fuma-nama/fumadocs/releases/tag/fumadocs-obsidian%401.0.6","date":"2026-10-09T10:08:16Z","type":"stable","version":"fumadocs-obsidian@1.0.6"}]` | `[{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.6.1","date":"2024-08-30T12:23:09Z","type":"stable","version":"1.6.1"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.6.0","date":"2024-04-20T17:55:01Z","type":"stable","version":"1.6.0"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.5.3","date":"2023-09-18T21:27:59Z","type":"stable","version":"1.5.3"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.5.2","date":"2023-08-02T14:54:19Z","type":"stable","version":"1.5.2"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.5.1","date":"2023-07-27T22:44:51Z","type":"stable","version":"1.5.1"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.5.0","date":"2023-07-26T20:39:53Z","type":"stable","version":"1.5.0"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.4.3","date":"2023-05-02T21:19:16Z","type":"stable","version":"1.4.3"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.4.2","date":"2022-11-01T18:34:14Z","type":"stable","version":"1.4.2"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.4.1","date":"2022-10-15T19:19:40Z","type":"stable","version":"1.4.1"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.4.0","date":"2022-09-27T17:38:06Z","type":"stable","version":"1.4.0"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.3.1","date":"2022-07-19T07:28:26Z","type":"stable","version":"1.3.1"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.3.0","date":"2022-03-26T19:55:09Z","type":"stable","version":"1.3.0"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.2.4","date":"2022-03-26T19:39:40Z","type":"stable","version":"1.2.4"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.2.3","date":"2021-10-12T21:59:03Z","type":"stable","version":"1.2.3"},{"url":"https://github.com/mkdocs/mkdocs/releases/tag/1.2.2","date":"2021-07-18T19:32:00Z","type":"stable","version":"1.2.2"}]` |
| security.scorecard | - | 4.1 |
| security.vulnerabilities | `{"count":0,"source":"https://advisories.ecosyste.ms/api/v1/advisories?ecosystem=npm&package_name=fumadocs-openapi&per_page=100","last_12m":0,"max_severity":null}` | `{"count":1,"source":"https://advisories.ecosyste.ms/api/v1/advisories?ecosystem=pypi&package_name=mkdocs&per_page=100","last_12m":0,"max_severity":"HIGH"}` |

## Capabilities (Documentation Tools)

| Capability | Fumadocs | MkDocs |
|---|:--:|:--:|
| **Core** |  |  |
| Tool kind | Static-site generator | Static-site generator |
| Engine / language | React | Python |
| **Authoring** |  |  |
| Authoring format | MDX | Markdown |
| **API docs** |  |  |
| API reference from OpenAPI / code | ✓ | ✓ |
| **Content** |  |  |
| Multi-version docs | - | - |
| Internationalisation | - | ✓ |
| **Discovery** |  |  |
| Search | Algolia DocSearch | - |
| **Design** |  |  |
| Theming / custom design | ✓ | ✓ |
| **Workflow** |  |  |
| Edit-in-Git / WYSIWYG round-trip | - | - |
| **Deployment** |  |  |
| Self-hostable | ✓ | ✓ |
| Official managed host | ✗ | ✗ |
| **Insight** |  |  |
| Built-in usage analytics | - | - |

*Source: vioscaleAI. Generated 2026-10-16T05:51:41.647Z. "-" = undocumented, not absent.*