GitBook against ReadMe on what an agent reads
In short
GitBook publishes /llms.txt listing every published page with a markdown version, and /llms-full.txt with the full content in one file. GitBook: Every published docs site exposes an MCP server at /~gitbook/mcp. ReadMe leads on llms.txt linking, 2 to 1; GitBook: The docs page links the files; a home page or header link by default is not documented.
The sourced difference
GitBook includes hidden pages in llms-full.txt and its MCP server; ReadMe lets a project replace the generated llms.txt with a file from Git, which stops automatic updates. Source, read 4 November 2026.
The rubric side by side
| Key | GitBook | ReadMe |
|---|---|---|
| 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 | 2, on by default |
| llms.txt linking | 1, with setup | 2, on by default |
| Markdown on request | 1, with setup | 1, with setup |
| JSON-LD output | 0, not offered | 0, not offered |
| OpenAPI exposure | 1, with setup | 2, on by default |
| Fenced, tagged code | 2, on by default | 2, on by default |
| Total | 11 of 16 | 13 of 16 |
The two differ on 2 of the numeric keys: llms.txt linking, OpenAPI exposure. Evidence for each score is on the profiles of GitBook and ReadMe.
Verdicts by reader
- Technical SEO
- Check what hidden content GitBook exposes before relying on hiding as access control.
- Docs owner
- ReadMe offers more control over the file; GitBook exposes more surfaces by default.
- Front-end developer
- Both need no code; the difference is configuration.
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.
ReadMe
- Does not promise that an agent will request llms.txt.
- Does not keep a custom llms.txt in sync with content changes.
Work left to the developer: GitBook, Low: nothing to switch on; check hidden pages before publishing, since they appear in llms-full.txt. ReadMe, Low: review the AI Discoverability toggles; a custom llms.txt stops automatic updates.
Sources
- gitbook.com: the difference https://gitbook.com/docs/publishing-documentation/llm-ready-docs, read 4 November 2026
- ReadMe: documentation https://docs.readme.com/main/docs/ai-discoverability, read 4 November 2026
Last reviewed 4 November 2026