# Gatsby vs MkDocs

| Attribute | Gatsby | MkDocs |
|---|---|---|
| **Vioscale score** | 52.5 (65% (medium)) | 55 (68% (medium)) |
| activity.commits_last_30d | 1 | 0 |
| adoption.github_stars | 55,941 | 22,380 |
| adoption.package_downloads_weekly | 296,956 | 3,992,344 |
| deployment.options | `{"cloud":true,"self_hosted":true}` | `{"cloud":true,"self_hosted":true}` |
| description.long | An open-source web framework built on React that helps developers create high-performance websites by integrating multiple content sources and services through a unified GraphQL data layer. | 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":"JavaScript/React","git_sync":true,"authoring":"markdown","themeable":true,"api_reference":true,"self_hostable":true,"hosted_offering":true}` | `{"i18n":true,"kind":"static_generator","engine":"Python","authoring":"markdown","themeable":true,"api_reference":true,"self_hostable":true,"hosted_offering":false}` |
| integrations.count | 4 | - |
| integrations.list | `[{"name":"Netlify"},{"name":"Google APIs"},{"name":"WordPress"},{"name":"Drupal"}]` | - |
| language.primary | JavaScript | Python |
| license.spdx | MIT | BSD-2-Clause |
| platform.support | `{"cli":true,"web":true}` | `{"cli":true,"web":true}` |
| pricing | `{"type":"free","freeTier":true,"sourceUrl":"https://gatsbyjs.com","retrievedAt":"2026-08-14T09:25:47.724Z"}` | `{"type":"open_source","sourceUrl":"https://www.mkdocs.org","retrievedAt":"2026-08-14T15:21:13.062Z"}` |
| pricing.free_tier | yes | yes |
| pricing.model | free | open_source |
| pricing.price_level | free | free |
| pricing.transparent | no | - |
| release.cadence_days | - | 77 |
| release.history | `[{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.16.1","date":"2026-02-10T14:38:44Z","type":"stable","version":"gatsby@5.16.1"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.16.0","date":"2026-01-26T21:26:57Z","type":"stable","version":"gatsby@5.16.0"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.15.0","date":"2025-08-27T17:53:08Z","type":"stable","version":"gatsby@5.15.0"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.14.6","date":"2025-08-27T12:39:42Z","type":"stable","version":"gatsby@5.14.6"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.14.5","date":"2025-08-27T12:34:32Z","type":"stable","version":"gatsby@5.14.5"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.14.4","date":"2025-08-27T12:32:59Z","type":"stable","version":"gatsby@5.14.4"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.14.3","date":"2025-08-27T12:30:01Z","type":"stable","version":"gatsby@5.14.3"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-source-wordpress%407.15.0","date":"2025-08-27T12:27:50Z","type":"stable","version":"gatsby-source-wordpress@7.15.0"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.14.2","date":"2025-08-27T12:23:24Z","type":"stable","version":"gatsby@5.14.2"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-source-shopify%409.0.0","date":"2025-01-07T19:52:06Z","type":"stable","version":"gatsby-source-shopify@9.0.0"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-link%405.14.1","date":"2025-01-07T19:48:32Z","type":"stable","version":"gatsby-link@5.14.1"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-source-contentful%408.15.0","date":"2025-01-07T19:44:56Z","type":"stable","version":"gatsby-source-contentful@8.15.0"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.14.0","date":"2024-11-06T20:17:17Z","type":"stable","version":"gatsby@5.14.0"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-source-shopify%408.13.2","date":"2024-10-28T15:42:26Z","type":"stable","version":"gatsby-source-shopify@8.13.2"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-source-wordpress%407.13.5","date":"2024-10-28T15:36:49Z","type":"stable","version":"gatsby-source-wordpress@7.13.5"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.13.7","date":"2024-10-28T15:32:16Z","type":"stable","version":"gatsby@5.13.7"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.13.6","date":"2024-10-28T15:31:14Z","type":"stable","version":"gatsby@5.13.6"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.13.5","date":"2024-10-28T15:30:22Z","type":"stable","version":"gatsby@5.13.5"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby-source-contentful%408.13.2","date":"2024-10-28T15:29:03Z","type":"stable","version":"gatsby-source-contentful@8.13.2"},{"url":"https://github.com/gatsbyjs/gatsby/releases/tag/gatsby%405.13.4","date":"2024-10-28T15:28:08Z","type":"stable","version":"gatsby@5.13.4"}]` | `[{"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"}]` |
| reliability.status_page | yes | - |
| security.disclosure_policy | yes | - |
| security.gdpr | yes | - |
| security.scorecard | 6.8 | 4.1 |
| security.soc2 | yes | - |

## Capabilities (Documentation Tools)

| Capability | Gatsby | MkDocs |
|---|:--:|:--:|
| **Core** |  |  |
| Tool kind | Static-site generator | Static-site generator |
| Engine / language | JavaScript/React | Python |
| **Authoring** |  |  |
| Authoring format | Markdown | Markdown |
| **API docs** |  |  |
| API reference from OpenAPI / code | ✓ | ✓ |
| **Content** |  |  |
| Multi-version docs | - | - |
| Internationalisation | - | ✓ |
| **Discovery** |  |  |
| Search | - | - |
| **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:15:40.781Z. "-" = undocumented, not absent.*