Skip to main content
Content fix guide

Markdown or Plain Text Docs Available

No alternative content format (markdown, plain text, or API) observed on the homepage. Providing machine-readable content formats improves AI extractability.

Issue ID: AI-MARKDOWN-001
Severity: advisory
Impact: Low
Effort: M

Use this article when

  • You need deeper remediation guidance than the issue card can show.
  • You want CMS-specific steps before handing the fix to a developer.
  • You want a repeatable re-check path after shipping the change.
Re-run full audit

What this issue is

No alternative content format (markdown, plain text, or API) observed on the homepage. Providing machine-readable content formats improves AI extractability.

Why it matters

No alternative content format (markdown, plain text, or API) observed on the homepage. Providing machine-readable content formats improves AI extractability. This affects clarity, topical depth, and whether a visitor sees an obvious reason to keep reading.

How we detect it

  • FreeSiteAudit flags this issue when the rule for AI-MARKDOWN-001 fails and the page evidence points to Dom body.
  • You can usually confirm this by checking the page source or the relevant page settings inside your CMS.

Evidence examples

Check the affected page source, rendered output, or relevant CMS setting to confirm the missing or incorrect element.

How to fix it

  1. 1Consider offering an /api or /feed endpoint for key content
  2. 2Provide a /llms.txt file with structured content guidance
  3. 3Ensure RSS/Atom feeds are available for blog content

How to re-check it

  • At least one machine-readable content format is available

Related tools

This issue is best verified with the full FreeSiteAudit crawl rather than a single-point mini tool.