--- title: "Docusaurus: agent readability profile: Agent Ready HTML" description: "Docusaurus scores 7 of 16 on the read-layer rubric: initial HTML, status codes, llms.txt, markdown, JSON-LD, OpenAPI and code. Read 2026-11-04." canonical: https://agentreadyhtml.com/platforms/docusaurus/ site: "Agent Ready HTML" last_updated: 2026-11-04 section: "Platforms" --- # Docusaurus: agent readability profile: Agent Ready HTML > Docusaurus scores 7 of 16 on the read-layer rubric: initial HTML, status codes, llms.txt, markdown, JSON-LD, OpenAPI and code. Read 2026-11-04. Source: https://agentreadyhtml.com/platforms/docusaurus/ Site: Agent Ready HTML Last reviewed: 2026-11-04 # Docusaurus: what an agent reads In short Docusaurus does not ship llms.txt in core. Docusaurus totals 7 of 16 on the eight numeric keys, from a test build of Docusaurus 3.10.2. It also does not negotiate markdown on its own, since output is static files. Docusaurus: Docusaurus is a static site generator and generates HTML files for every possible path at build time. **rubric.txt** docusaurus ```text initial_html_by_default = 2 real_status_codes = 2 llms_txt_generation = 0 llms_txt_linking = 0 markdown_negotiation = 0 jsonld_output = 1 openapi_exposure = 0 fenced_code = 2 total = 7 of 16 ``` Test build of 3.10.2, 2026-11-04. **Docusaurus** Framework, Meta Open Source Open-source static site generator for docs: HTML for every route at build time, with llms.txt only through community plugins. Work left to the developer: Medium: write or install an llms.txt plugin, link it in the footer, and add the host rule for Accept; the 404 page is already built. ## The nine scores | Key | Score | Evidence | Source | | --- | --- | --- | --- | | Content in the initial HTML | 2, on by default | Test build, Docusaurus 3.10.2, 2026-11-04: the classic template prerendered the home page with an H1 and the docs pages with their text. | docusaurus.io/docs/advanced/ssg, 2026-11-04 | | Real status codes | 2, on by default | Test build: build/ held 404.html and docusaurus serve answered a made-up path with 404 directly. | docusaurus.io/docs/advanced/ssg, 2026-11-04 | | llms.txt generation | 0, not offered | Test build: no llms.txt or robots.txt in build/ (sitemap.xml was written). Docusaurus has no first-party llms.txt feature; community plugins exist and none was installed. | docusaurus.io/docs/seo, 2026-11-04 | | llms.txt linking | 0, not offered | Test build: nothing links an llms.txt and none exists. | docusaurus.io/docs/seo, 2026-11-04 | | Markdown on request | 0, not offered | Test build: Accept: text/markdown on / returned text/html and /index.md returned 404. The output is static files, so negotiation has to live in the host or an edge rule, the same need Astro has. | docusaurus.io/docs/advanced/ssg, 2026-11-04 | | JSON-LD output | 1, with setup | Test build: no JSON-LD emitted. A script element can be added through the config head tags. | docusaurus.io/docs/seo, 2026-11-04 | | OpenAPI exposure | 0, not offered | Test build: no OpenAPI file or link; Docusaurus has no first-party feature for one. | docusaurus.io/docs/advanced/ssg, 2026-11-04 | | Fenced, tagged code | 2, on by default | Test build: a fence in a docs page became a pre element with a language class (language-md) from Prism, with no setup. | docusaurus.io/docs/markdown-features/code-blocks, 2026-11-04 | | Work left to the developer | | Medium: write or install an llms.txt plugin, link it in the footer, and add the host rule for Accept; the 404 page is already built. Based on the test build above and the documentation pages cited for each key. | docusaurus.io/docs/seo, 2026-11-04 | ## Test build Docusaurus 3.10.2, built on 4 November 2026. create-docusaurus classic template in TypeScript, npm run build, docusaurus serve. What it emitted: - The home page HTML held an H1 (hero\_\_title) and the docs pages were prerendered. - build/ held 404.html, sitemap.xml and the pages; no llms.txt, no robots.txt. - A made-up path returned 404 directly from docusaurus serve. - Accept: text/markdown on / returned text/html; /index.md returned 404. - Fenced code became pre with a language-md style class from Prism. - No JSON-LD and no link rel alternate markdown. Scoring rules for every key are on the [method page](https://agentreadyhtml.com/method/). ## What the documentation says Each statement below carries its source and the date read. Statements a vendor makes about itself are labelled as vendor claims. - Docusaurus is a static site generator and generates HTML files for every possible path at build time. \[primary source\] [source](https://docusaurus.io/docs), read 4 November 2026. - Docusaurus server-side renders React at build time to produce static HTML pages. \[primary source\] [source](https://docusaurus.io/docs/advanced/ssg), read 4 November 2026. - docusaurus.io itself returned 404 for /llms.txt on 2026-11-04. \[primary source\] https://docusaurus.io/llms.txt (404 on the read date), read 4 November 2026. - The community plugin docusaurus-plugin-llms writes llms.txt and llms-full.txt during a production build with no configuration, and strips HTML and import statements. \[primary source\] [source](https://github.com/rachfop/docusaurus-plugin-llms), read 4 November 2026. - The plugin supports custom LLM files, multi-instance docs and multi-version output. \[primary source\] [source](https://github.com/rachfop/docusaurus-plugin-llms), read 4 November 2026. ## What it does not do - Does not ship llms.txt in core. - Does not negotiate markdown on its own, since output is static files. ## Compare and replace - [Docusaurus against Mintlify](https://agentreadyhtml.com/compare/docusaurus-vs-mintlify/) - [Docusaurus against GitBook](https://agentreadyhtml.com/compare/gitbook-vs-docusaurus/) - [Alternatives to Docusaurus](https://agentreadyhtml.com/platforms/docusaurus/alternatives/) - [Docusaurus: vendor profile](https://agentreadyhtml.com/vendors/docusaurus/) - [Docusaurus home page](https://docusaurus.io/) ## Sources 1. [Docusaurus introduction](https://docusaurus.io/docs) https://docusaurus.io/docs, read 4 November 2026 2. [Docusaurus static site generation](https://docusaurus.io/docs/advanced/ssg) https://docusaurus.io/docs/advanced/ssg, read 4 November 2026 3. docusaurus.io https://docusaurus.io/llms.txt (404 on the read date), read 4 November 2026 4. [docusaurus-plugin-llms](https://github.com/rachfop/docusaurus-plugin-llms) https://github.com/rachfop/docusaurus-plugin-llms, read 4 November 2026 5. [docusaurus.io](https://docusaurus.io/docs/seo) https://docusaurus.io/docs/seo, read 4 November 2026 6. [docusaurus.io](https://docusaurus.io/docs/markdown-features/code-blocks) https://docusaurus.io/docs/markdown-features/code-blocks, read 4 November 2026 7. [docusaurus.io](https://docusaurus.io/) https://docusaurus.io/, read 4 November 2026 Last reviewed 4 November 2026 Edition Crawl 2026-11-04 Page updated 2026-11-04 Method How the viewer reads a page, how a file is graded and how a platform is scored: [the method page](https://agentreadyhtml.com/method/).