GitBook against Docusaurus on what an agent reads
In short
GitBook: Hidden pages are included in llms-full.txt and stay reachable through the MCP server; hiding only removes a page from the table of contents. Docusaurus server-side renders React at build time to produce static HTML pages. GitBook leads on llms.txt generation, 2 to 0; Docusaurus: no llms.txt or robots.txt in build/ (sitemap.xml was written).
The sourced difference
GitBook publishes llms.txt, llms-full.txt, .md twins and an MCP server for every site; Docusaurus core publishes static HTML only and relies on community plugins for llms.txt. Source, read 4 November 2026.
The rubric side by side
| Key | GitBook | Docusaurus |
|---|---|---|
| Content in the initial HTML | 2, on by default | 2, on by default |
| Real status codes | 2, on by default | 2, on by default |
| llms.txt generation | 2, on by default | 0, not offered |
| llms.txt linking | 1, with setup | 0, not offered |
| Markdown on request | 1, with setup | 0, not offered |
| JSON-LD output | 0, not offered | 1, with setup |
| OpenAPI exposure | 1, with setup | 0, not offered |
| Fenced, tagged code | 2, on by default | 2, on by default |
| Total | 11 of 16 | 7 of 16 |
The two differ on 5 of the numeric keys: llms.txt generation, llms.txt linking, markdown on request, JSON-LD output, OpenAPI exposure. Evidence for each score is on the profiles of GitBook and Docusaurus.
Verdicts by reader
- Technical SEO
- Docusaurus HTML is clean; agent files are the gap.
- Docs owner
- GitBook is hosted and automatic; Docusaurus is free and self-managed.
- Front-end developer
- Docusaurus needs a plugin plus host rules.
What each leaves undone
GitBook
- Does not exclude hidden pages from llms-full.txt or the MCP server.
- Does not document Accept-header negotiation on the LLM-ready docs page.
Docusaurus
- Does not ship llms.txt in core.
- Does not negotiate markdown on its own, since output is static files.
Work left to the developer: GitBook, Low: nothing to switch on; check hidden pages before publishing, since they appear in llms-full.txt. Docusaurus, 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.
Sources
- gitbook.com: the difference https://gitbook.com/docs/publishing-documentation/llm-ready-docs, read 4 November 2026
- Docusaurus: documentation https://docusaurus.io/docs/advanced/ssg, read 4 November 2026
Last reviewed 4 November 2026