# MkDocs vs Nextra

| Attribute | MkDocs | Nextra |
|---|---|---|
| **Vioscale score** | 55 (68% (medium)) | 50.9 (61% (medium)) |
| activity.commits_last_30d | 0 | 0 |
| adoption.dependent_repos | - | 2,302 |
| adoption.github_stars | 22,380 | 13,911 |
| adoption.package_downloads_weekly | 3,992,344 | 218,218 |
| deployment.options | `{"cloud":true,"self_hosted":true}` | `{"cloud":true,"hybrid":true,"self_hosted":true}` |
| description.long | 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. | An open-source site generator that combines Next.js with Markdown and MDX, providing automatic link/image optimization, built-in full-text search, internationalization, and hybrid rendering capabilities for documentation and content sites. |
| features.capabilities | `{"i18n":true,"kind":"static_generator","engine":"Python","authoring":"markdown","themeable":true,"api_reference":true,"self_hostable":true,"hosted_offering":false}` | `{"i18n":true,"kind":"static_generator","engine":"Next.js","search":"built_in","git_sync":true,"analytics":false,"authoring":"mdx","themeable":true,"versioning":true,"api_reference":true,"self_hostable":true,"hosted_offering":false}` |
| language.primary | Python | TypeScript |
| license.spdx | BSD-2-Clause | MIT |
| market.availability | - | `{"primaryMarkets":[],"availabilityScope":"global","availableCountries":[],"notAvailableCountries":[]}` |
| platform.support | `{"cli":true,"web":true}` | `{"cli":true,"web":true}` |
| pricing | `{"type":"open_source","sourceUrl":"https://www.mkdocs.org","retrievedAt":"2026-08-14T15:21:13.062Z"}` | `{"type":"open_source","freeTier":true,"sourceUrl":"https://nextra.site","retrievedAt":"2026-08-14T09:20:08.323Z"}` |
| pricing.free_tier | yes | yes |
| pricing.model | open_source | open_source |
| pricing.price_level | free | free |
| release.cadence_days | 77 | - |
| release.history | `[{"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"}]` | `[{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.6.1","date":"2025-12-04T10:30:12Z","type":"stable","version":"nextra@4.6.1"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.6.1","date":"2025-12-04T10:30:15Z","type":"stable","version":"nextra-theme-docs@4.6.1"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-blog%404.6.1","date":"2025-12-04T10:30:10Z","type":"stable","version":"nextra-theme-blog@4.6.1"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.6.0","date":"2025-10-02T14:50:10Z","type":"stable","version":"nextra@4.6.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.6.0","date":"2025-10-02T14:50:07Z","type":"stable","version":"nextra-theme-docs@4.6.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-blog%404.6.0","date":"2025-10-02T14:50:04Z","type":"stable","version":"nextra-theme-blog@4.6.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.5.1","date":"2025-09-27T16:37:30Z","type":"stable","version":"nextra@4.5.1"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.5.1","date":"2025-09-27T16:37:27Z","type":"stable","version":"nextra-theme-docs@4.5.1"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-blog%404.5.1","date":"2025-09-27T16:37:24Z","type":"stable","version":"nextra-theme-blog@4.5.1"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.5.0","date":"2025-09-21T16:08:44Z","type":"stable","version":"nextra@4.5.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.5.0","date":"2025-09-21T16:08:50Z","type":"stable","version":"nextra-theme-docs@4.5.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-blog%404.5.0","date":"2025-09-21T16:08:47Z","type":"stable","version":"nextra-theme-blog@4.5.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.4.0","date":"2025-08-22T09:43:05Z","type":"stable","version":"nextra@4.4.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.4.0","date":"2025-08-22T09:43:11Z","type":"stable","version":"nextra-theme-docs@4.4.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-blog%404.4.0","date":"2025-08-22T09:43:08Z","type":"stable","version":"nextra-theme-blog@4.4.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.3.0","date":"2025-07-28T15:07:46Z","type":"stable","version":"nextra@4.3.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.3.0","date":"2025-07-28T15:07:52Z","type":"stable","version":"nextra-theme-docs@4.3.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-blog%404.3.0","date":"2025-07-28T15:07:49Z","type":"stable","version":"nextra-theme-blog@4.3.0"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra%404.3.0-alpha.31","date":"2025-07-10T13:04:14Z","type":"prerelease","version":"nextra@4.3.0-alpha.31"},{"url":"https://github.com/shuding/nextra/releases/tag/nextra-theme-docs%404.3.0-alpha.31","date":"2025-07-10T13:04:20Z","type":"prerelease","version":"nextra-theme-docs@4.3.0-alpha.31"}]` |
| security.scorecard | 4.1 | 3.4 |
| security.vulnerabilities | - | `{"count":0,"source":"https://advisories.ecosyste.ms/api/v1/advisories?ecosystem=npm&package_name=nextra&per_page=100","last_12m":0,"max_severity":null}` |

## Capabilities (Documentation Tools)

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

*Source: Vioscale. Generated 2026-09-01T17:02:12.238Z. "-" = undocumented, not absent.*