--- title: "MkDocs: vendor profile: Agent Ready HTML" description: "MkDocs, a framework: 2 of 6 standards stated as supported, 12 sourced facts, dated plans and what it does not do. Read 2026-11-05." canonical: https://agentreadyhtml.com/vendors/mkdocs/ site: "Agent Ready HTML" last_updated: 2026-11-05 section: "Vendors" --- # MkDocs: vendor profile: Agent Ready HTML > MkDocs, a framework: 2 of 6 standards stated as supported, 12 sourced facts, dated plans and what it does not do. Read 2026-11-05. Source: https://agentreadyhtml.com/vendors/mkdocs/ Site: Agent Ready HTML Last reviewed: 2026-11-05 # 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 ```text 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](https://agentreadyhtml.com/vendors/by-type/framework/) Home page [www.mkdocs.org](https://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](https://www.mkdocs.org/), read 5 November 2026. - Every MkDocs build includes a 404.html in the build directory. \[primary source\] [source](https://www.mkdocs.org/user-guide/deploying-your-docs/), 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](https://www.mkdocs.org/user-guide/deploying-your-docs/), 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](https://www.mkdocs.org/user-guide/configuration/), 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](https://www.mkdocs.org/user-guide/configuration/), 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](https://www.mkdocs.org/user-guide/configuration/), 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](https://www.mkdocs.org/about/release-notes/), 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](https://www.mkdocs.org/about/release-notes/), 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](https://squidfunk.github.io/mkdocs-material/blog/), read 5 November 2026. - MkDocs is distributed under a BSD licence, copyright 2014 Tom Christie. \[primary source\] [source](https://www.mkdocs.org/about/license/), 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](https://www.mkdocs.org/user-guide/configuration/), 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](https://www.mkdocs.org/user-guide/configuration/), read 5 November 2026. ## Products and plans | Product | What it is | Price | As of | Source | | --- | --- | --- | --- | --- | | MkDocs | Static site generator for project documentation written in Markdown. | Free, open source; BSD licence, free; 1.6.1 is the newest release listed | 2026-11-05 | source | ## Standards | Standard | Status | What the vendor's pages say | Source | | --- | --- | --- | --- | | llms-txt | no statement | No 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-negotiation | no statement | No statement found in the MkDocs user guide pages read; the configuration page answered Accept: text/markdown with HTML. | none | | markdown-twin | no statement | No statement found in the MkDocs configuration reference or release notes about publishing Markdown copies of pages. | none | | initial-html | supports | MkDocs describes itself as a static site generator whose build writes HTML pages from Markdown. | source | | real-404 | supports | MkDocs includes a 404.html in every build; whether a host serves it depends on the host, per the deploying guide. | source | | vary-accept | no statement | No statement found in the MkDocs deploying or configuration pages; MkDocs writes files and sets no response headers. | none | ## Checks on its own site | Reading | Result | Date | | --- | --- | --- | | Home page request | HTTP 200; H1 in the initial HTML: yes; 276 words; 0 JSON-LD blocks | 2026-11-05 | | Request with Accept: text/markdown | HTTP 200, text/html, Vary: Accept-Encoding | 2026-11-05 | | /llms.txt at the host root | HTTP 404, text/html, 9.8 KB | 2026-11-05 | | A made-up path | HTTP 404 | 2026-11-05 | | Ora score, cached | Not available: GET /api/score returned 404 DOMAIN_NOT_SCANNED | 2026-11-05 | | Cloudflare keyless scan | Not available: scanner could not fetch the site: HTTP 526 | 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 - [Frameworks in this section](https://agentreadyhtml.com/vendors/by-type/framework/) - [The Plain Fetch viewer](https://agentreadyhtml.com/viewer/) ## Sources 1. [MkDocs](https://www.mkdocs.org/) https://www.mkdocs.org/, read 5 November 2026 2. [Deploying Your Docs - MkDocs](https://www.mkdocs.org/user-guide/deploying-your-docs/) https://www.mkdocs.org/user-guide/deploying-your-docs/, read 5 November 2026 3. [Configuration - MkDocs](https://www.mkdocs.org/user-guide/configuration/) https://www.mkdocs.org/user-guide/configuration/, read 5 November 2026 4. [Release Notes - MkDocs](https://www.mkdocs.org/about/release-notes/) https://www.mkdocs.org/about/release-notes/, read 5 November 2026 5. [Material for MkDocs blog](https://squidfunk.github.io/mkdocs-material/blog/) https://squidfunk.github.io/mkdocs-material/blog/, read 5 November 2026 6. [MkDocs License (BSD)](https://www.mkdocs.org/about/license/) https://www.mkdocs.org/about/license/, read 5 November 2026 Last reviewed 5 November 2026 Edition Crawl 2026-11-04 Page updated 2026-11-05 Method How the viewer reads a page, how a file is graded and how a platform is scored: [the method page](https://agentreadyhtml.com/method/).