GitBook: what an agent reads
In short
GitBook does not exclude hidden pages from llms-full.txt or the MCP server. GitBook totals 11 of 16 on the eight numeric keys, from cited documentation read 4 November 2026. It also does not document Accept-header negotiation on the LLM-ready docs page.
rubric.txt gitbook
initial_html_by_default = 2
real_status_codes = 2
llms_txt_generation = 2
llms_txt_linking = 1
markdown_negotiation = 1
jsonld_output = 0
openapi_exposure = 1
fenced_code = 2
total = 11 of 16
Read 2026-11-04. Documentation, not a test build.
GitBook Docs platform, GitBook
Hosted docs platform that publishes .md pages, llms.txt, llms-full.txt and an MCP server for every published docs site.
Work left to the developer: Low: nothing to switch on; check hidden pages before publishing, since they appear in llms-full.txt.
The nine scores
| Key | Score | Evidence | Source |
|---|---|---|---|
| Content in the initial HTML | 2, on by default | Published pages are served with content in the HTML; the .md twin exists for every page. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| Real status codes | 2, on by default | A made-up path on www.gitbook.com returned 404. Observed on the vendor's own site with a plain fetch on 2026-11-04; the vendor's own site may not use default settings. | GET gitbook.com/agent-ready-html-missing-path-check: 404 as observed, 2026-11-04 |
| llms.txt generation | 2, on by default | llms.txt and llms-full.txt published automatically. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| llms.txt linking | 1, with setup | The docs page links the files; a home page or header link by default is not documented. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| Markdown on request | 1, with setup | The .md suffix is documented; Accept-header negotiation is not documented on the page read, although gitbook.com answered it. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| JSON-LD output | 0, not offered | Not documented on the AI pages read. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| OpenAPI exposure | 1, with setup | OpenAPI blocks are supported in GitBook docs; exposure in llms.txt is not documented on the page read. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| Fenced, tagged code | 2, on by default | Markdown export of pages keeps code blocks as markdown. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
| Work left to the developer | Low: nothing to switch on; check hidden pages before publishing, since they appear in llms-full.txt. Hidden pages are included in llms-full.txt. Not test-built: publishing needs a GitBook account. Score from the documentation page cited, read 2026-11-04. | gitbook.com/docs/publishing-documentation/llm-ready-docs, 2026-11-04 |
Test build
Not test-built: the scores above come from the documentation pages cited in each row, read 4 November 2026, because the platform needs an account or a paid plan. The reason is in each evidence cell.
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.
- Appending .md to any published GitBook page URL returns its markdown. [primary source] source, read 4 November 2026.
- GitBook publishes /llms.txt listing every published page with a markdown version, and /llms-full.txt with the full content in one file. [primary source] source, read 4 November 2026.
- 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. [primary source] source, read 4 November 2026.
- Every published docs site exposes an MCP server at /~gitbook/mcp. [primary source] source, read 4 November 2026.
- GitBook runs an agent-readiness checker for docs built on the afdocs library plus its own checks. [vendor claim] source, read 4 November 2026.
- GitBook states that 51.8 percent of intentional documentation reads on GitBook are AI agents. [vendor claim] source, read 4 November 2026.
- On 2026-11-04 a request to www.gitbook.com with Accept: text/markdown returned text/markdown. [primary source] source, read 4 November 2026.
What it does not do
- 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.
Compare and replace
- GitBook against Mintlify
- GitBook against ReadMe
- GitBook against Docusaurus
- Alternatives to GitBook
- GitBook: vendor profile
- GitBook home page
Sources
- GitBook docs: LLM-ready docs https://gitbook.com/docs/publishing-documentation/llm-ready-docs, read 4 November 2026
- GitBook agent-readiness checker https://gitbook.com/agent-score, read 4 November 2026
- gitbook.com https://www.gitbook.com/, read 4 November 2026
- gitbook.com https://www.gitbook.com/agent-ready-html-missing-path-check (a probe path that answers 404 on purpose), read 4 November 2026
Last reviewed 4 November 2026