Skip to content

Rank #4 of 5 in Developer Docs Platforms

Docusaurus logo

Docusaurus

Open Source

Meta Open Source

66.2k7.2k/yrnpm 1.3M/wk

Access

Install

npxnpx create-docusaurus@latest my-website classic

Compare head-to-head

Alternatives to Docusaurus

Showcase

Docusaurus homepage screenshot
homepage · captured Sep 2026 · view live ↗
Docusaurus docs screenshot
docs · captured Sep 2026 · view live ↗

Try itExperimental

See what an agent can do with Docusaurus before you ever sign up. Pick a story: recorded sessions replay real probe-harness transcripts; sandboxed self-drive sessions are designed and gated (docs/TRY-IT.md).

$mktemp -d && npx -y create-docusaurus@latest pa-probe classic --typescript --skip-install && ls pa-proberecorded session — replayed, not live
recorded 2026-09-08 · exit 0 · captured verbatim by our probe harness, secrets redacted

Verified integrations

No integration evidence found in our corpus for this product yet — that means none was found, never that it doesn’t integrate.

By theme — the product's score on each story themeBy theme

Agenticness — how well agents can access and operate the productAgenticnessevidence →

How well agents can access and operate the product

20.2/100

Ai docs — stories about ai docs in this arenaAi docsevidence →

Stories about ai docs in this arena

0.0/100

Analytics insights — stories about analytics insights in this arenaAnalytics insightsevidence →

Stories about analytics insights in this arena

0.0/100

Api reference — stories about api reference in this arenaApi referenceevidence →

Stories about api reference in this arena

0.0/100

Authoring editing — stories about authoring editing in this arenaAuthoring editingevidence →

Stories about authoring editing in this arena

18.0/100

Automation depth — how much of the product can run unattendedAutomation depthevidence →

How much of the product can run unattended

0.0/100

Collaboration review — stories about collaboration review in this arenaCollaboration reviewevidence →

Stories about collaboration review in this arena

n/a

Customization — bending the product to your needs — settings, theming, extension pointsCustomizationevidence →

Bending the product to your needs — settings, theming, extension points

90.0/100

Docs as code — stories about docs as code in this arenaDocs as codeevidence →

Stories about docs as code in this arena

48.0/100

Openness — open source, data portability, and self-hosting storiesOpennessevidence →

Open source, data portability, and self-hosting stories

81.3/100

Privacy posture — data-handling and privacy storiesPrivacy postureevidence →

Data-handling and privacy stories

0.0/100

Publishing hosting — stories about publishing hosting in this arenaPublishing hostingevidence →

Stories about publishing hosting in this arena

48.0/100

Search discovery — stories about search discovery in this arenaSearch discoveryevidence →

Stories about search discovery in this arena

30.0/100

Versioning localization — stories about versioning localization in this arenaVersioning localizationevidence →

Stories about versioning localization in this arena

90.0/100

Story verdicts — every judged story with its evidenceStory verdicts

What’s free: 8 free · 0 paid · 0 enterprise · 8 not stated in evidence

?

Sorted by importance (agentic first) (high → low) · 53/53 stories · click a row’s chevron for the rationale and evidence

Drive the product through a documented public API G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness3partialfree4/10T

Connect an agent via an official MCP server G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness3n/auntestednone yet

Delegate tasks to a built-in AI assistant inside the product G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness3n/auntestednone yet

Plug MCP servers into this product so it can use their tools G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness3n/auntestednone yet

Use an official CLI G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2fullfree7/10T

Run the product headlessly / in CI for automation G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2partialfree6/10T

Build against official SDKs G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2partial5/10T

Download a machine-readable API spec (OpenAPI or equivalent) G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness2none0/10

Explore an interactive API reference with runnable examples G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness2none0/10

Point an agent at llms.txt or agent-oriented docs G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2none0/10

Rely on versioned APIs with a documented deprecation policy G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness2none0/10

Get AI-generated insights and suggestions from my data inside the product G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness2n/auntestednone yet

Issue scoped/least-privilege API credentials for an agent G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2n/auntestednone yet

Operate the product with natural-language commands G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness2n/auntestednone yet

Set up automations that run autonomously in the background G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness2n/auntestednone yet

Subscribe to events via webhooks G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2n/auntestednone yet

Test against a sandbox environment without touching production data G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness1n/auntestednone yet

I publish versioned documentation per product or API version, and readers switch versions from the site C

Versioning

developerVersioning localization — stories about versioning localization in this arenaVersioning localization3full9/10C

Self-host the core product G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness3fullfree9/10X

Export all of my data in open formats and leave G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness3fullfree8/10X

My docs live in my own git repository — branches, pull requests, and merges drive what gets published C

Git workflow

developerDocs as code — stories about docs as code in this arenaDocs as code3full8/10X

I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML C

Authoring

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing3partial6/10X

Readers get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the box C

Search

developerSearch discovery — stories about search discovery in this arenaSearch discovery3partialfree5/10C

Every published page serves clean markdown at its URL (e.g. appending .md) so agents skip the HTML C

Agent output

ai-native userAi docs — stories about ai docs in this arenaAi docs3none0/10

My API reference pages are generated from an OpenAPI spec and stay in sync when the spec changes C

Spec driven

developerApi reference — stories about api reference in this arenaApi reference3none0/10

My published docs site automatically serves llms.txt (and a full-content variant) so agents can index it C

Agent output

ai-native userAi docs — stories about ai docs in this arenaAi docs3none0/10

My published docs site exposes its own MCP server that my users' agents can query for search and page content C

Agent access

ai-native userAi docs — stories about ai docs in this arenaAi docs3none0/10

Define rules that trigger actions automatically on events G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth3n/auntestednone yet

Prevent my data from being used to train AI models G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture3n/auntestednone yet

Export my entire docs site as a static bundle and host it anywhere, so my content is never locked in C

Portability

developerPublishing hosting — stories about publishing hosting in this arenaPublishing hosting2fullfree9/10C

I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand C

Theming

devrel leadCustomization — bending the product to your needs — settings, theming, extension pointsCustomization2full9/10X

Read the product's source under an open license G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness2fullfree7/10X

I serve docs on my own custom domain or as a /docs subpath of my main site C

Domains

devrel leadPublishing hosting — stories about publishing hosting in this arenaPublishing hosting2partial5/10C

Choose where my data is stored (region/residency) G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture2n/a0/10

Do everything through the API that I can do in the UI G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness2n/a0/10

Every docs pull request gets a shareable preview deployment before it merges C

Git workflow

developerDocs as code — stories about docs as code in this arenaDocs as code2n/a0/10

Perform bulk operations across many items at once G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth2none0/10

Readers can try real API calls from an interactive playground embedded in the reference docs C

Playground

developerApi reference — stories about api reference in this arenaApi reference2none0/10

A platform AI agent drafts, updates, and reviews my docs — from a prompt, a PR, or a schedule — and ships its work as change requests C

Writer agent

ai-native userAi docs — stories about ai docs in this arenaAi docs2n/auntestednone yet

An embedded AI assistant on my docs site answers reader questions with citations into my content C

Assistant

ai-native userAi docs — stories about ai docs in this arenaAi docs2noneuntestednone yet

Automated checks lint my content against a style guide and flag issues before they publish C

Quality

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing2noneuntestednone yet

CI validation catches broken links and invalid configuration before the site publishes C

Quality gates

developerDocs as code — stories about docs as code in this arenaDocs as code2noneuntestednone yet

Control data retention and deletion G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture2n/auntestednone yet

I see page views, search terms, and reader feedback so I know which docs work and which fail C

Analytics

devrel leadAnalytics insights — stories about analytics insights in this arenaAnalytics insights2noneuntestednone yet

My docs analytics distinguish AI-agent traffic from human traffic so I can see who — or what — is actually reading C

Analytics

ai-native userAnalytics insights — stories about analytics insights in this arenaAnalytics insights2n/auntestednone yet

Non-technical teammates can edit docs in a visual web editor without touching git, and their changes flow into the same source of truth C

Authoring

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing2noneuntestednone yet

Opt out of telemetry and usage tracking G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture2noneuntestednone yet

Schedule recurring jobs or workflows G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth2n/auntestednone yet

Teammates propose changes that go through review — comments, approvals, and a merge step — before they publish C

Review

technical writerCollaboration review — stories about collaboration review in this arenaCollaboration review2n/auntestednone yet

I publish my docs in multiple languages with translated navigation and content C

Localization

technical writerVersioning localization — stories about versioning localization in this arenaVersioning localization1full9/10C

Reusable snippets and variables keep repeated content in sync across pages C

Content reuse

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing1partial6/10C

I gate some or all docs behind authentication — password, JWT, or SSO — for customers-only content G

Access control

devrel leadPublishing hosting — stories about publishing hosting in this arenaPublishing hosting1none0/10

Version, review, and roll back my automations G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth1n/auntestednone yet

Opportunities — the stories that would move this product's scores, from its own judged verdictsOpportunitiestop 8 of 24 stories with headroom

What would move Docusaurus’s scores — derived from its own judged verdicts, biggest headroom first. Each line quotes what the judge found missing; shipping it (or evidencing it publicly) is the fix.

  1. Ai docs — stories about ai docs in this arenaMy published docs site exposes its own MCP server that my users' agents can query for search and page content

    nonemoves PA Scoreimpact 30

    No evidence Docusaurus generates or exposes an MCP server for published docs sites; search is via Algolia DocSearch, not an agent-queryable MCP endpoint, and probes for llms.txt/docs.md/openapi all 404.

  2. Ai docs — stories about ai docs in this arenaMy published docs site automatically serves llms.txt (and a full-content variant) so agents can index it

    nonemoves PA Scoreimpact 30

    No evidence Docusaurus core ships automatic llms.txt or full-content markdown variant generation; direct probes of the Docusaurus own site show 404 for both llms.txt and docs.md, and no docs mention this feature.

  3. Ai docs — stories about ai docs in this arenaEvery published page serves clean markdown at its URL (e.g. appending .md) so agents skip the HTML

    nonemoves PA Scoreimpact 30

    Docusaurus builds static HTML from Markdown/MDX but there is no evidence of a per-page clean-markdown endpoint (e.g.

  4. Api reference — stories about api reference in this arenaMy API reference pages are generated from an OpenAPI spec and stay in sync when the spec changes

    nonemoves PA Scoreimpact 30

    No evidence pack item mentions OpenAPI spec import, API reference page generation, or spec-sync capability; Docusaurus core is described as a Markdown/MDX static-site generator with docs/blog/pages plugins, not an OpenAPI-driven doc generator.

  5. Agenticness — how well agents can access and operate the productPoint an agent at llms.txt or agent-oriented docs

    nonemoves agent-readyimpact 30

    Probes show Docusaurus's own site has no llms.txt (404) and no agent-oriented docs.md endpoint (404), and no docs evidence describes shipping llms.txt support for generated sites either.

  6. Agenticness — how well agents can access and operate the productExplore an interactive API reference with runnable examples

    nonemoves API qualityimpact 30

    Docusaurus's evidence shows only generic MDX/React embedding, versioning, i18n, and search features—no built-in interactive API reference or runnable-example tooling (e.g., OpenAPI/Swagger integration) is documented, and probes for openapi.json/swagger.json all return 404.

  7. Agenticness — how well agents can access and operate the productDownload a machine-readable API spec (OpenAPI or equivalent)

    nonemoves API qualityimpact 30

    Docusaurus is a documentation site generator, not an API service, but it could plausibly expose a machine-readable spec of its own CLI/config or plugin API; probes explicitly show no OpenAPI/swagger spec exists at any expected path, and no docs mention publishing one.

  8. Agenticness — how well agents can access and operate the productRely on versioned APIs with a documented deprecation policy

    nonemoves API qualityimpact 30

    The pack shows Docusaurus has a 'document versioning' feature for content (docs-6, docs-19, docs-23), but that is unrelated to the story's ask about the framework's own APIs (plugin API, config schema, npm package) being semantically versioned with a documented deprecation policy.

Showing the top 8 of 24 — every none/partial verdict in the story verdicts table is headroom.

Think a verdict is wrong? Every verdicts-table row has a Flag link — see the methodology.

Coverage map — which docs area, API section, or community source covers which judged storiesCoverage map5 surfaces · 16 covered stories

Where the cited evidence behind each covered verdict came from — the same citations the verdicts table shows, no extra judging.

Probe proofs — replayable recordings from the probe harnessProbe proofs

Replayable recordings from our probe harness — see the Prove-It protocol to submit one.

$mktemp -d && npx -y create-docusaurus@latest pa-probe classic --typescript --skip-install && ls pa-probereproduced
$ mktemp -d && npx -y create-docusaurus@latest pa-probe classic --typescript --skip-install && ls pa-probe

  `cd pa-probe`
  `npm start`

Happy building awesome websites!

--- scaffold files ---
README.md		docusaurus.config.ts	src
blog			package.json		static
docs			sidebars.ts		tsconfig.json

Claims vs evidence — vendor claims reconciled against independent verdictsClaims vs evidence

3 of 7 testable claims verified · 0 contradictedintegrity 43/100

15 distinct capability claims found in Docusaurus’s own claimed-docs/GitHub materials, reconciled against our judge’s independent verdicts.

3

Verified

4

Unverified

0

Contradicted

9

Undersold

Verified (7)
Unverified (5)
Undersold (9)
Claims outside our story set (4)

Real capability claims found in Docusaurus’s own materials, but no story in this arena’s taxonomy covers them yet — that’s feedback on the taxonomy, not a mark against the product.

  • Site features (docs, blog, pages) are each provided by separate installable npm plugins

    source ↗
  • Local development server builds and serves a live preview of the site via Webpack Dev Server

    source ↗
  • Blog plugin enables deploying a full-featured blog quickly

    source ↗
  • Markdown parser can opt in to strict CommonMark format via site config

    source ↗
Suggest a story for these →

Business model

open-source

Free and open source (MIT license) from Meta; you host the generated static site yourself, so the only costs are your own hosting.

pricing ↗

Score trend

How this product’s scores have moved as evidence and verdicts are re-derived — a point per change, not per day.

PA Score32 (Sep 8 '26)30 (Sep 16 '26)
Agent-ready36 (Sep 8 '26)31 (Sep 16 '26)

Try Experimental

Run it in the microterminal →

Recorded agent sessions — and a live MCP handshake where the vendor ships one.

Flag

⚑ Flag a verdict

Think a verdict is wrong? Opens a prefilled GitHub issue — or use the ⚑ next to any verdict above.

Badge

Embed this product's score badge →

Hotlinked SVG — always shows the live current score.

For agents

Data