Agent Ready HTML

MkDocs: vendor profile

In short

MkDocs turns Markdown and one mkdocs.yml into HTML pages with a 404.html and a compressed sitemap, and writes no llms.txt or per-page Markdown copy. The newest release, 1.6.1, dates from 2024-08-30. www.mkdocs.org answered a markdown request with 72,736 bytes of HTML, and GitHub Pages uses the 404.html only on a custom domain.

At a glance

standards.txt mkdocs

llms-txt               = no statement
markdown-negotiation   = no statement
markdown-twin          = no statement
initial-html           = supports
real-404               = supports
vary-accept            = no statement

2 supports, 0 partial or announced, 4 no statement.

MkDocs Framework

Python static site generator that turns Markdown and one mkdocs.yml into HTML pages with a 404.html and a compressed sitemap; no llms.txt or Markdown output is documented, and the newest 1.x release dates from 2024-08-30.

Type
Framework
Home page
www.mkdocs.org, answered HTTP 200 on 2026-11-05
Last read
5 November 2026

What it does for this layer

  • MkDocs builds a static documentation site from Markdown source files configured by a single YAML file. [primary source] source, read 5 November 2026.
  • Every MkDocs build includes a 404.html in the build directory. [primary source] source, read 5 November 2026.
  • MkDocs warns that GitHub Pages picks up its 404.html automatically only on a custom domain, and other servers need their own configuration to use it. [primary source] source, read 5 November 2026.
  • MkDocs's site_url, null by default, adds a canonical link tag to the head of each HTML page. [primary source] source, read 5 November 2026.
  • use_directory_urls defaults to true in MkDocs, so a page such as about.md is published as about/index.html with a trailing-slash URL. [primary source] source, read 5 November 2026.
  • MkDocs turns on its bundled search plugin by default, but any plugins list in mkdocs.yml replaces the defaults, so search must be listed again. [primary source] source, read 5 November 2026.
  • MkDocs 1.6.0 (2024-04-20) made sitemap.xml.gz change at most once per day instead of on every build. [primary source, 2024-04-20] source, read 5 November 2026.
  • The MkDocs release notes still list 1.6.1 of 2024-08-30 as the newest version on 2026-11-05. [primary source, 2024-08-30] source, read 5 November 2026.
  • The Material for MkDocs team wrote on 2026-02-18 that MkDocs 1.x is unmaintained, with no releases in the 18 months before, and that MkDocs 2.0 was still a pre-release. [secondary source, 2026-02-18] source, read 5 November 2026.
  • MkDocs is distributed under a BSD licence, copyright 2014 Tom Christie. [primary source] source, read 5 November 2026.
  • www.mkdocs.org returned a 404 HTML page for /llms.txt on 2026-11-05 while /sitemap.xml and /sitemap.xml.gz both answered 200. [observed] source, read 5 November 2026.
  • Requested with Accept: text/markdown on 2026-11-05, the MkDocs configuration page on www.mkdocs.org still came back as 72,736 bytes of HTML. [observed] source, read 5 November 2026.

Products and plans

Plans and prices as the vendor's own pages showed them on the date read.
ProductWhat it isPriceAs ofSource
MkDocsStatic site generator for project documentation written in Markdown.Free, open source
BSD licence, free; 1.6.1 is the newest release listed		2026-11-05source

Standards

The six standards this site tracks; no statement means the pages read said nothing.
StandardStatusWhat the vendor's pages saySource
llms-txtno statementNo statement found in the MkDocs configuration, deploying and release notes pages; www.mkdocs.org/llms.txt returned 404, and llms.txt comes only from third-party plugins such as mkdocs-llmstxt.none
markdown-negotiationno statementNo statement found in the MkDocs user guide pages read; the configuration page answered Accept: text/markdown with HTML.none
markdown-twinno statementNo statement found in the MkDocs configuration reference or release notes about publishing Markdown copies of pages.none
initial-htmlsupportsMkDocs describes itself as a static site generator whose build writes HTML pages from Markdown.source
real-404supportsMkDocs includes a 404.html in every build; whether a host serves it depends on the host, per the deploying guide.source
vary-acceptno statementNo statement found in the MkDocs deploying or configuration pages; MkDocs writes files and sets no response headers.none

Checks on its own site

Readings of mkdocs.org, the vendor's own website, which describe that site and not the product.
ReadingResultDate
Home page requestHTTP 200; H1 in the initial HTML: yes; 276 words; 0 JSON-LD blocks2026-11-05
Request with Accept: text/markdownHTTP 200, text/html, Vary: Accept-Encoding2026-11-05
/llms.txt at the host rootHTTP 404, text/html, 9.8 KB2026-11-05
A made-up pathHTTP 4042026-11-05
Ora score, cachedNot available: GET /api/score returned 404 DOMAIN_NOT_SCANNED2026-11-05
Cloudflare keyless scanNot available: scanner could not fetch the site: HTTP 526 <none>2026-11-05

What it does not do

  • MkDocs core generates no llms.txt and no per-page Markdown copy; projects add the third-party mkdocs-llmstxt plugin for that.

Related pages on this site

Sources

  1. MkDocs https://www.mkdocs.org/, read 5 November 2026
  2. Deploying Your Docs - MkDocs https://www.mkdocs.org/user-guide/deploying-your-docs/, read 5 November 2026
  3. Configuration - MkDocs https://www.mkdocs.org/user-guide/configuration/, read 5 November 2026
  4. Release Notes - MkDocs https://www.mkdocs.org/about/release-notes/, read 5 November 2026
  5. Material for MkDocs blog https://squidfunk.github.io/mkdocs-material/blog/, read 5 November 2026
  6. MkDocs License (BSD) https://www.mkdocs.org/about/license/, read 5 November 2026

Last reviewed 5 November 2026