Docus: vendor profile
In short
Docus negotiates Accept: text/markdown with Vary: Accept, User-Agent and sends agents a Markdown 404, but outside Vercel prerendered pages stay HTML and agents fall back to the .md twin. docus.dev returned 2,209 bytes of markdown for a docs page on 2026-11-05. The theme is free under the MIT licence; v5.15.0 shipped on 2026-10-14.
At a glance
standards.txt docus
llms-txt = supports
markdown-negotiation = partial
markdown-twin = supports
initial-html = supports
real-404 = supports
vary-accept = supports
5 supports, 1 partial or announced, 0 no statement.
Docus Framework
Nuxt documentation theme that ships llms.txt and llms-full.txt through nuxt-llms, a .md twin and /raw/ Markdown for every page, Accept: text/markdown negotiation with Vary: Accept, User-Agent, Markdown 404s for agents, JSON-LD and an MCP server.
What it does for this layer
- Docus is a Nuxt documentation theme built with Nuxt UI and Nuxt Content, and new projects start from npx create-docus my-docs. [primary source] source, read 5 November 2026.
- Docus includes the nuxt-llms module by default, which generates and pre-renders /llms.txt and /llms-full.txt from every documentation page. [primary source] source, read 5 November 2026.
- Docus switches a page to Markdown when the URL ends in .md, when the Accept header prefers text/markdown over text/html, or when the User-Agent is a known AI crawler such as ClaudeBot or GPTBot. [primary source] source, read 5 November 2026.
- Every Docus response that can be HTML or Markdown carries Vary: Accept, User-Agent so a CDN never hands the wrong variant to a browser or an agent. [primary source] source, read 5 November 2026.
- Docus negotiation runs in a Nitro middleware and, on Vercel, at the edge; on other hosts a prerendered page stays HTML and agents reach its Markdown through the .md URL. [primary source] source, read 5 November 2026.
- Docus serves source Markdown at /raw/<content-path>.md with text/markdown and a Link header back to the HTML page, and rewrites llms.txt links to those raw files. [primary source] source, read 5 November 2026.
- Docus emits JSON-LD through nuxt-schema-org, with WebSite and WebPage on every page and TechArticle and BreadcrumbList on documentation pages. [primary source] source, read 5 November 2026.
- Docus generates /sitemap.xml with @nuxtjs/sitemap and turns it into a sitemap index with one sitemap per locale on multilingual sites. [primary source] source, read 5 November 2026.
- Each Docus site exposes an MCP server at the /mcp path of its documentation URL. [primary source] source, read 5 November 2026.
- Docus v5.15.0, released on GitHub on 2026-10-14, lazy-loads components and tree-shakes schema.org composables out of the client bundle. [primary source, 2026-10-14] source, read 5 November 2026.
- docus.dev answered Accept: text/markdown on /en/getting-started/installation with 2,209 bytes of text/markdown and Vary: Accept, User-Agent on 2026-11-05. [observed] source, read 5 November 2026.
- With curl's default Accept, a made-up docus.dev path returned status 404 with a 1,236-byte Markdown body on 2026-11-05; the same kind of path requested with Accept: text/html returned a 404 HTML page. [observed] source, read 5 November 2026.
Products and plans
| Product | What it is | Price | As of | Source |
|---|---|---|---|---|
| Docus | Nuxt layer and theme for Markdown documentation sites. | Free, open source MIT licence, free; v5.15.0 on 2026-10-14 | 2026-11-05 | source |
Standards
| Standard | Status | What the vendor's pages say | Source |
|---|---|---|---|
| llms-txt | supports | Docus integrates nuxt-llms by default and generates and pre-renders /llms.txt and /llms-full.txt. | source |
| markdown-negotiation | partial | Docus negotiates on the page URL through a Nitro middleware, but outside Vercel prerendered pages stay HTML and agents need the .md URL. | source |
| markdown-twin | supports | Every page has a markdown twin by default at the page URL plus .md, backed by /raw/<path>.md. | source |
| initial-html | supports | Docus pages are prerendered; its docs describe prerendered pages being served ahead of the middleware. | source |
| real-404 | supports | Docus keeps the 404 status on missing pages, as Markdown for agents and as the theme error page for browsers. | source |
| vary-accept | supports | Docus sends Vary: Accept, User-Agent on every response that negotiates. | source |
Checks on its own site
| Reading | Result | Date |
|---|---|---|
| Home page request | HTTP 200; H1 in the initial HTML: yes; 458 words; 1 JSON-LD block | 2026-11-05 |
| Request with Accept: text/markdown | HTTP 200, text/markdown, Vary: Accept, User-Agent | 2026-11-05 |
| /llms.txt at the host root | HTTP 200, text/plain, 8.4 KB, starts with an H1 | 2026-11-05 |
| A made-up path | HTTP 404 | 2026-11-05 |
| Ora score, cached | 55, grade C | 2026-09-15 |
| Cloudflare keyless scan | 53, L5 Agent-Native | 2026-11-05 |
What it does not do
- Docus does not send its Markdown 404 to browsers or JSON clients; requests accepting text/html or application/json keep the regular error responses. source, read 5 November 2026.
Related pages on this site
Sources
- Docus: home page https://docus.dev/, read 5 November 2026
- Introduction - Docus https://docus.dev/en/getting-started/introduction, read 5 November 2026
- LLMs Integration - Docus https://docus.dev/en/ai/llms, read 5 November 2026
- Configuration - Docus https://docus.dev/en/concepts/configuration, read 5 November 2026
- MCP Server - Docus https://docus.dev/en/ai/mcp, read 5 November 2026
- Releases · nuxt-content/docus · GitHub https://github.com/nuxt-content/docus/releases, read 5 November 2026
- Docus LICENSE https://raw.githubusercontent.com/nuxt-content/docus/main/LICENSE, read 5 November 2026
Last reviewed 5 November 2026