What this check measures
markdown-negotiation — Content.
AIDE check markdown-negotiation — under the content category. Learn what it measures, why it matters and how to fix it.
Profiles using this check: ai_ready
Why it matters
Most of the signals AI agents and classic search engines use come from content structure: heading hierarchy, readability, language tagging, answer blocks. If structure is broken, even high-quality copy can't be parsed correctly.
How AIDE tests it
AIDE's scanner inspects your HTML, response headers, and where applicable external signals to evaluate markdown-negotiation, then returns PASS / WARNING / FAIL / SKIPPED against the threshold. Weight: 0.9 points, severity: medium.
How to fix it
- Exactly one
<h1>, then a clean<h2>/<h3>hierarchy. - Summarise the page topic in a single sentence inside the first paragraph.
- Use question headings followed by direct-answer blocks (50–150 chars).
Related resources
- Profile landing: AI_READY
- aide.tr/learn