Rank #4 of 5 in Developer Docs Platforms
Access
Install
npx create-docusaurus@latest my-website classicShowcase


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 liveVerified 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
Ai docs — stories about ai docs in this arenaAi docsevidence →
Stories about ai docs in this arena
Analytics insights — stories about analytics insights in this arenaAnalytics insightsevidence →
Stories about analytics insights in this arena
Api reference — stories about api reference in this arenaApi referenceevidence →
Stories about api reference in this arena
Authoring editing — stories about authoring editing in this arenaAuthoring editingevidence →
Stories about authoring editing in this arena
Automation depth — how much of the product can run unattendedAutomation depthevidence →
How much of the product can run unattended
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
Docs as code — stories about docs as code in this arenaDocs as codeevidence →
Stories about docs as code in this arena
Openness — open source, data portability, and self-hosting storiesOpennessevidence →
Open source, data portability, and self-hosting stories
Privacy posture — data-handling and privacy storiesPrivacy postureevidence →
Data-handling and privacy stories
Publishing hosting — stories about publishing hosting in this arenaPublishing hostingevidence →
Stories about publishing hosting in this arena
Search discovery — stories about search discovery in this arenaSearch discoveryevidence →
Stories about search discovery in this arena
Versioning localization — stories about versioning localization in this arenaVersioning localizationevidence →
Stories about versioning localization in this arena
Story verdicts — every judged story with its evidenceStory verdicts
What’s free: 8 free · 0 paid · 0 enterprise · 8 not stated in evidence
Follow the green: where the map greys out is where Docusaurus stops today. ✓ full · ~ partial · ! disputed · — none · n/a not applicable.
Agenticness — how well agents can access and operate the productAgenticness
How well agents can access and operate the product
API surface
Drive the product through a documented public API
~4/10
unlocks → Machine-readable spec · Versioning policy · Readers can try real API calls from an interactive playground embedded in the reference docs · My API reference pages are generated from an OpenAPI spec and stay in sync when the spec changes
Subscribe to events via webhooks
n/an/a
Build against official SDKs
~5/10
Issue scoped/least-privilege API credentials for an agent
n/an/a
Connect an agent via an official MCP server
n/an/a
Download a machine-readable API spec (OpenAPI or equivalent)
—0/10
Rely on versioned APIs with a documented deprecation policy
—0/10
Test against a sandbox environment without touching production data
n/an/a
Explore an interactive API reference with runnable examples
—0/10
Docs for agents
Point an agent at llms.txt or agent-oriented docs
—0/10
Agentic features
Delegate tasks to a built-in AI assistant inside the product
n/an/a
Operate the product with natural-language commands
n/an/a
Plug MCP servers into this product so it can use their tools
n/an/a
Get AI-generated insights and suggestions from my data inside the product
n/an/a
Set up automations that run autonomously in the background
n/an/a
Ai docs — stories about ai docs in this arenaAi docs
Stories about ai docs in this arena
My published docs site exposes its own MCP server that my users' agents can query for search and page content
—0/10
Agent output
An embedded AI assistant on my docs site answers reader questions with citations into my content
—–
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
n/an/a
Analytics insights — stories about analytics insights in this arenaAnalytics insights
Stories about analytics insights in this arena
Api reference — stories about api reference in this arenaApi reference
Stories about api reference in this arena
Authoring editing — stories about authoring editing in this arenaAuthoring editing
Stories about authoring editing in this arena
Automation depth — how much of the product can run unattendedAutomation depth
How much of the product can run unattended
Collaboration review — stories about collaboration review in this arenaCollaboration review
Stories about collaboration review in this arena
Customization — bending the product to your needs — settings, theming, extension pointsCustomization
Bending the product to your needs — settings, theming, extension points
Docs as code — stories about docs as code in this arenaDocs as code
Stories about docs as code in this arena
Openness — open source, data portability, and self-hosting storiesOpenness
Open source, data portability, and self-hosting stories
Privacy posture — data-handling and privacy storiesPrivacy posture
Data-handling and privacy stories
Publishing hosting — stories about publishing hosting in this arenaPublishing hosting
Stories about publishing hosting in this arena
Search discovery — stories about search discovery in this arenaSearch discovery
Stories about search discovery in this arena
Versioning localization — stories about versioning localization in this arenaVersioning localization
Stories about versioning localization in this arena
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 user | Agenticness — how well agents can access and operate the productAgenticness | 3 | partialfree | 4/10 | Tprobed | |
Connect an agent via an official MCP server G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | n/a | untested | none yet | |
Delegate tasks to a built-in AI assistant inside the product G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | n/a | untested | none yet | |
Plug MCP servers into this product so it can use their tools G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | n/a | untested | none yet | |
Use an official CLI G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | fullfree | 7/10 | Tprobed | |
Run the product headlessly / in CI for automation G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partialfree | 6/10 | Tprobed | |
Build against official SDKs G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 5/10 | Tprobed | |
Download a machine-readable API spec (OpenAPI or equivalent) G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Explore an interactive API reference with runnable examples G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Point an agent at llms.txt or agent-oriented docs G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Rely on versioned APIs with a documented deprecation policy G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Get AI-generated insights and suggestions from my data inside the product G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | n/a | untested | none yet | |
Issue scoped/least-privilege API credentials for an agent G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | n/a | untested | none yet | |
Operate the product with natural-language commands G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | n/a | untested | none yet | |
Set up automations that run autonomously in the background G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | n/a | untested | none yet | |
Subscribe to events via webhooks G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | n/a | untested | none yet | |
Test against a sandbox environment without touching production data G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 1 | n/a | untested | none yet | |
I publish versioned documentation per product or API version, and readers switch versions from the site C Versioning | developer | Versioning localization — stories about versioning localization in this arenaVersioning localization | 3 | full | 9/10 | Cclaimed | |
Self-host the core product G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 3 | fullfree | 9/10 | Xcommunity | |
Export all of my data in open formats and leave G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 3 | fullfree | 8/10 | Xcommunity | |
My docs live in my own git repository — branches, pull requests, and merges drive what gets published C Git workflow | developer | Docs as code — stories about docs as code in this arenaDocs as code | 3 | full | 8/10 | Xcommunity | |
I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML C Authoring | technical writer | Authoring editing — stories about authoring editing in this arenaAuthoring editing | 3 | partial | 6/10 | Xcommunity | |
Readers get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the box C Search | developer | Search discovery — stories about search discovery in this arenaSearch discovery | 3 | partialfree | 5/10 | Cclaimed | |
Every published page serves clean markdown at its URL (e.g. appending .md) so agents skip the HTML C Agent output | ai-native user | Ai docs — stories about ai docs in this arenaAi docs | 3 | none | 0/10 | ||
My API reference pages are generated from an OpenAPI spec and stay in sync when the spec changes C Spec driven | developer | Api reference — stories about api reference in this arenaApi reference | 3 | none | 0/10 | ||
My published docs site automatically serves llms.txt (and a full-content variant) so agents can index it C Agent output | ai-native user | Ai docs — stories about ai docs in this arenaAi docs | 3 | none | 0/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 user | Ai docs — stories about ai docs in this arenaAi docs | 3 | none | 0/10 | ||
Define rules that trigger actions automatically on events G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 3 | n/a | untested | none yet | |
Prevent my data from being used to train AI models G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 3 | n/a | untested | none yet | |
Export my entire docs site as a static bundle and host it anywhere, so my content is never locked in C Portability | developer | Publishing hosting — stories about publishing hosting in this arenaPublishing hosting | 2 | fullfree | 9/10 | Cclaimed | |
I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand C Theming | devrel lead | Customization — bending the product to your needs — settings, theming, extension pointsCustomization | 2 | full | 9/10 | Xcommunity | |
Read the product's source under an open license G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 2 | fullfree | 7/10 | Xcommunity | |
I serve docs on my own custom domain or as a /docs subpath of my main site C Domains | devrel lead | Publishing hosting — stories about publishing hosting in this arenaPublishing hosting | 2 | partial | 5/10 | Cclaimed | |
Choose where my data is stored (region/residency) G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | n/a | 0/10 | ||
Do everything through the API that I can do in the UI G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 2 | n/a | 0/10 | ||
Every docs pull request gets a shareable preview deployment before it merges C Git workflow | developer | Docs as code — stories about docs as code in this arenaDocs as code | 2 | n/a | 0/10 | ||
Perform bulk operations across many items at once G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 2 | none | 0/10 | ||
Readers can try real API calls from an interactive playground embedded in the reference docs C Playground | developer | Api reference — stories about api reference in this arenaApi reference | 2 | none | 0/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 user | Ai docs — stories about ai docs in this arenaAi docs | 2 | n/a | untested | none yet | |
An embedded AI assistant on my docs site answers reader questions with citations into my content C Assistant | ai-native user | Ai docs — stories about ai docs in this arenaAi docs | 2 | none | untested | none yet | |
Automated checks lint my content against a style guide and flag issues before they publish C Quality | technical writer | Authoring editing — stories about authoring editing in this arenaAuthoring editing | 2 | none | untested | none yet | |
CI validation catches broken links and invalid configuration before the site publishes C Quality gates | developer | Docs as code — stories about docs as code in this arenaDocs as code | 2 | none | untested | none yet | |
Control data retention and deletion G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | n/a | untested | none yet | |
I see page views, search terms, and reader feedback so I know which docs work and which fail C Analytics | devrel lead | Analytics insights — stories about analytics insights in this arenaAnalytics insights | 2 | none | untested | none 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 user | Analytics insights — stories about analytics insights in this arenaAnalytics insights | 2 | n/a | untested | none 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 writer | Authoring editing — stories about authoring editing in this arenaAuthoring editing | 2 | none | untested | none yet | |
Opt out of telemetry and usage tracking G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | none | untested | none yet | |
Schedule recurring jobs or workflows G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 2 | n/a | untested | none yet | |
Teammates propose changes that go through review — comments, approvals, and a merge step — before they publish C Review | technical writer | Collaboration review — stories about collaboration review in this arenaCollaboration review | 2 | n/a | untested | none yet | |
I publish my docs in multiple languages with translated navigation and content C Localization | technical writer | Versioning localization — stories about versioning localization in this arenaVersioning localization | 1 | full | 9/10 | Cclaimed | |
Reusable snippets and variables keep repeated content in sync across pages C Content reuse | technical writer | Authoring editing — stories about authoring editing in this arenaAuthoring editing | 1 | partial | 6/10 | Cclaimed | |
I gate some or all docs behind authentication — password, JWT, or SSO — for customers-only content G Access control | devrel lead | Publishing hosting — stories about publishing hosting in this arenaPublishing hosting | 1 | none | 0/10 | ||
Version, review, and roll back my automations G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 1 | n/a | untested | none 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.
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.
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.
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.
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.
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.
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.
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.
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.
docs15 stories
- Run the product headlessly / in CI for automation
- Use an official CLI
- Drive the product through a documented public API
- Build against official SDKs
- I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML
- Reusable snippets and variables keep repeated content in sync across pages
- I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand
- My docs live in my own git repository — branches, pull requests, and merges drive what gets published
- Export all of my data in open formats and leave
- Self-host the core product
- I serve docs on my own custom domain or as a /docs subpath of my main site
- Export my entire docs site as a static bundle and host it anywhere, so my content is never locked in
- Readers get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the box
- I publish my docs in multiple languages with translated navigation and content
- I publish versioned documentation per product or API version, and readers switch versions from the site
docusaurus.io11 stories
- Build against official SDKs
- I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML
- Reusable snippets and variables keep repeated content in sync across pages
- I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand
- My docs live in my own git repository — branches, pull requests, and merges drive what gets published
- Export all of my data in open formats and leave
- Self-host the core product
- Export my entire docs site as a static bundle and host it anywhere, so my content is never locked in
- Readers get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the box
- I publish my docs in multiple languages with translated navigation and content
- I publish versioned documentation per product or API version, and readers switch versions from the site
Hacker News7 stories
- Run the product headlessly / in CI for automation
- I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML
- I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand
- My docs live in my own git repository — branches, pull requests, and merges drive what gets published
- Export all of my data in open formats and leave
- Read the product's source under an open license
- Self-host the core product
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 contradicted → integrity 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)
“Official CLI scaffolds a new Docusaurus site (create-docusaurus)”
“Write docs and blog posts in MDX; Docusaurus compiles them to static HTML”
I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTMLpartialproof ↗
“MDX lets you embed JSX/React components directly inside Markdown files”
I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTMLpartialproof ↗
“Site layout can be extended/customized with your own React components via a pluggable architecture”
I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brandfullproof ↗
“Custom global CSS can be added via a custom.css file with the classic theme”
I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brandfullproof ↗
“Swizzling lets you swap out a built-in theme component for your own implementation”
I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brandfullproof ↗
“Third-party or custom-defined components can be imported and used within MDX pages”
I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTMLpartialproof ↗
Unverified (5)
“Write docs and blog posts in MDX; Docusaurus compiles them to static HTML”
Export my entire docs site as a static bundle and host it anywhere, so my content is never locked infullproof ↗
“First-class built-in support for Algolia DocSearch for site search”
Readers get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the boxpartialproof ↗
“Versioning CLI creates a new documentation version snapshot from current docs”
I publish versioned documentation per product or API version, and readers switch versions from the sitefullproof ↗
“Built-in i18n support makes translating the whole site straightforward”
I publish my docs in multiple languages with translated navigation and contentfullproof ↗
“`npm run build` compiles the site into static files ready for hosting”
Export my entire docs site as a static bundle and host it anywhere, so my content is never locked infullproof ↗
Undersold (9)
Run the product headlessly / in CI for automationpartialproof ↗
Drive the product through a documented public APIpartialproof ↗
Reusable snippets and variables keep repeated content in sync across pagespartialproof ↗
My docs live in my own git repository — branches, pull requests, and merges drive what gets publishedfullproof ↗
I serve docs on my own custom domain or as a /docs subpath of my main sitepartialproof ↗
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 ↗
Business model
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.
Try Experimental
Run it in the microterminal →Recorded agent sessions — and a live MCP handshake where the vendor ships one.
Flag
⚑ Flag a verdictThink a verdict is wrong? Opens a prefilled GitHub issue — or use the ⚑ next to any verdict above.
For agents
