Redocly against Scalar on what an agent reads
In short
Redocly creates an llms.txt for each site that lists pages and links a clean markdown version of each, in the llmstxt.org format. Redocly: On 2026-11-04 redocly.com answered Accept: text/markdown with text/markdown. Redocly leads on content in the initial HTML, 2 to 1; Scalar: Docs pages are served as HTML; the API reference component renders in the browser in some embeds.
The sourced difference
Scalar Docs always serves llms.txt and llms-full.txt and users cannot author them; Redocly makes the llms.txt title, description and sections configurable under SEO config and lets it be turned off. Source, read 4 November 2026.
The rubric side by side
| Key | Redocly | Scalar |
|---|---|---|
| Content in the initial HTML | 2, on by default | 1, with setup |
| 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 | 1, with setup |
| Markdown on request | 1, with setup | 1, with setup |
| JSON-LD output | 0, not offered | 0, not offered |
| OpenAPI exposure | 2, on by default | 2, on by default |
| Fenced, tagged code | 2, on by default | 2, on by default |
| Total | 12 of 16 | 11 of 16 |
The two differ on 1 of the numeric keys: content in the initial HTML. Evidence for each score is on the profiles of Redocly and Scalar.
Verdicts by reader
- Technical SEO
- Scalar output is deterministic per build; Redocly can be tuned.
- Docs owner
- Pick Redocly if you need to curate the index, Scalar if you want zero settings.
- Front-end developer
- Both link OpenAPI from the docs; Scalar links the spec file inside llms.txt.
What each leaves undone
Redocly
- Does not document Accept-header negotiation on its AI-ready page.
- Does not document JSON-LD output for agents.
Scalar
- Does not let users author the generated llms.txt on hosted Scalar Docs.
- Does not include hidden pages.
Work left to the developer: Redocly, Low: configure llms.txt sections under SEO config. Scalar, Low on hosted Scalar Docs; medium for self-hosted API references, which need their own llms.txt route.
Sources
- scalar.com: the difference https://scalar.com/products/docs/configuration/llms-txt, read 4 November 2026
- Redocly: documentation https://redocly.com/docs/realm/ai-ready, read 4 November 2026
Last reviewed 4 November 2026