---
title: "Markdown negotiation | markdown for agents content negotiation | Agent-Ready Check"
description: "Give an agent markdown when it asks for markdown. Tokens are the expensive part of an agent run, and raw HTML is mostly markup it will throw away. Pass criteria: A request with Accept: text/markdown returns Content-Type: text/markdown, and HTML stays the default."
locale: en
canonical: https://agent-ready.t0ols.com/checks/markdown-negotiation/
---

# Markdown negotiation

> Category: Content

Give an agent markdown when it asks for markdown. Tokens are the expensive part of an agent run, and raw HTML is mostly markup it will throw away.

## Why it matters

One Content-Type check saves you a parser and saves the agent thousands of tokens on every page it reads.

## Pass criteria

A request with Accept: text/markdown returns Content-Type: text/markdown, and HTML stays the default.

## How to implement it

Goal: Return HTML responses as markdown when agents request it

A request with Accept: text/markdown returns Content-Type: text/markdown, and HTML stays the default.

The step-by-step implementation prompt is part of the paid tier. The free layer gives you the diagnosis, the evidence and the specification links.

Specifications: https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/
Implementation notes: https://agent-ready.t0ols.com/.well-known/agent-skills/markdown-negotiation/SKILL.md