# Content — Serving Machine-Readable Pages to Agents

> The agent-readiness dimension that serves machine-readable, answer-first pages — markdown twins, content negotiation, JSON-LD, meta and canonicals.

## What the content dimension means

The content dimension makes the substance of your pages readable by machines, not just rendered for humans. Once an agent has discovered you, it has to extract your actual answer without wrestling layout markup, scripts and navigation chrome. This dimension serves the same meaning in a form an agent can lift cleanly — a markdown copy, a negotiated format, structured facts, and unambiguous metadata — and structures the prose answer-first so the useful sentence is the first sentence.

## Signals and standards it covers

- **Markdown twins** — a `.md` copy of every HTML page so agents read your content without parsing layout markup.
- **Content negotiation** — returning `text/markdown` (or JSON) when an agent sends `Accept: text/markdown`, so one URL serves humans and machines the right format. Use the media type registered with IANA.
- **JSON-LD / schema.org** — structured markup so an agent extracts facts as data, not prose to re-parse.
- **Clean meta, canonical and Open Graph** — an accurate title and description, a single canonical URL so the agent knows which version is authoritative, and OG tags for consistent representation.
- **Answer-first structure and FAQ schema** — leading each section with a standalone declarative answer; answer-first content plus schema is reported as a strong citation signal as of 2026.

## How the Agent-Readiness Audit scores it

The Audit scores content on whether an agent can retrieve a clean, structured version of each page. The check `content.markdown_twin` passes when a page has a reachable `.md` twin, and `content.content_negotiation` passes when the same URL returns `text/markdown` for an `Accept: text/markdown` request. Further checks confirm a single canonical, a present meta description, and at least one valid JSON-LD block. Each criterion is checkable by fetching the URL — no judgment call. Every page on this site has a `.md` twin, and requesting this page with `Accept: text/markdown` returns markdown.

Related: [schema.org for agents](/protocols/discovery/schema-org) · [serve markdown twins](/agent-readiness/markdown-twins) · [return text/markdown](/agent-readiness/content-negotiation) · [get cited by AI (GEO)](/geo) · [audit your site](/services)