---
title: "Markdown negotiation: glossary: Agent Ready HTML"
description: "Markdown negotiation defined: Content negotiation where Accept: text/markdown returns the page as markdown with Content-Type text/markdown."
canonical: https://agentreadyhtml.com/glossary/markdown-negotiation/
site: "Agent Ready HTML"
last_updated: 2026-11-04
section: "Glossary"
---

# Markdown negotiation: glossary: Agent Ready HTML

> Markdown negotiation defined: Content negotiation where Accept: text/markdown returns the page as markdown with Content-Type text/markdown.

Source: https://agentreadyhtml.com/glossary/markdown-negotiation/
Site: Agent Ready HTML
Last reviewed: 2026-11-04

# Markdown negotiation

In short

Content negotiation where Accept: text/markdown returns the page as markdown with Content-Type text/markdown. Example: Cloudflare Radar found markdown negotiation passing on 3.9 percent of scanned sites. Related terms: Accept header, Content negotiation, Markdown twin, Vary: Accept, llms.txt. Accept header: The request header that lists media types a client will take, with optional q weights.

## Source of the example

The example in the summary above is from [blog.cloudflare.com](https://blog.cloudflare.com/agent-readiness/), read 4 November 2026.

## Where it shows up on this site

-   [Guide: serve markdown on request](https://agentreadyhtml.com/guides/serve-markdown-on-request/)
-   [Markdown negotiation by platform](https://agentreadyhtml.com/markdown-negotiation-by-platform/)

## Neighbouring terms

-   [Accept header](https://agentreadyhtml.com/glossary/accept-header/): The request header that lists media types a client will take, with optional q weights.
-   [Content negotiation](https://agentreadyhtml.com/glossary/content-negotiation/): The HTTP mechanism where the client states preferred formats in the Accept header and the server picks a representation for the same URL.
-   [Markdown twin](https://agentreadyhtml.com/glossary/markdown-twin/): A markdown copy of a page at a predictable URL, such as page.md or page.html.md.
-   [Vary: Accept](https://agentreadyhtml.com/glossary/vary-accept/): A response header telling caches that the body depends on the Accept header, so HTML and markdown are stored separately.
-   [llms.txt](https://agentreadyhtml.com/glossary/llms-txt/): A markdown file at /llms.txt that names a site, summarises it and lists links to LLM-friendly pages.

## Sources

1.  [blog.cloudflare.com](https://blog.cloudflare.com/agent-readiness/) https://blog.cloudflare.com/agent-readiness/, read 4 November 2026

Last reviewed 4 November 2026

Edition

Crawl

2026-11-04

Page updated

2026-11-04

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/).