Core format · included on every plan

Markdown

Your page, in the format LLMs were trained on.

5 / 5GEO score
MD · Geordypage.md
Why it matters

Markdown is the lowest-friction text format LLMs are trained on at massive scale - model weights understand `#`, `>`, `**` and bullet lists natively, so well-structured Markdown is parsed more reliably than HTML when ingested into context windows or RAG pipelines. Almost every AI coding tool, doc site, and chat UI consumes it as first-class input.

Geordy generates this format for every page on your site that warrants it - auto-detected by page type, served from your subdomain, and refreshed on the cadence below.

Sample outputpage.md
# Geordy

## What is GEO?

GEO is the practice of optimizing content for AI-powered search engines.

## Key Features

- **Multi-format generation**: 16 AI-optimized formats
- **AI bot tracking**: Monitor GPTBot, ClaudeBot, PerplexityBot
Get it right

How to make this format work for AI.

DoBest practices
  • Use ATX-style headings (`#`, `##`) and keep a single H1 per document; LLMs use heading hierarchy to chunk and route content.
  • Prefer fenced code blocks with a language tag (```python) - improves both human syntax highlighting and LLM code understanding.
  • Write descriptive link text - `[CommonMark spec](https://spec.commonmark.org)` not `[click here](...)`; link text becomes context for the model.
  • Stick to CommonMark or GitHub Flavored Markdown; avoid renderer-specific extensions if the file will be ingested by external tools.
AvoidCommon pitfalls
  • Mixing tabs and spaces in nested lists - most parsers and LLM tokenizers lose the structure.
  • Skipping a blank line before a list, code block, or heading - the original Markdown spec requires it and many parsers will silently merge the elements.
  • Embedding raw HTML for layout (divs, spans) - defeats portability and often gets stripped in RAG pre-processing.
Where it shines

Use cases, scored for AI visibility.

Documentation and README filesGEO 5/5
Content writing and blog postsGEO 5/5
Note-taking and knowledge managementGEO 3/5
Used in production by

Real sites already shipping Markdown.

Working with it

Tools & resources for Markdown.

The trade-offs
Strengths
  • Simple, intuitive syntax that's easy to learn
  • Widely supported across major platforms (GitHub, Reddit, Stack Overflow)
  • Plain text format compatible with version control
  • No special software required - works in any text editor
Limitations
  • Limited formatting compared to HTML
  • Inconsistent implementations across platforms
  • No standard for complex tables or diagrams
Spec sheet
Filename
page.md
Refresh cadence
weekly
Released
2004 · John Gruber & Aaron Swartz
Written forGPTBotClaudeBotPerplexityBotGeneral LLM systems

Written for these readers. Which of them actually request it is measured, not assumed: see how we measure.

Documented support
  • CommonMark specification 0.31.2Defines Markdown as a lightweight plain-text format for structured documents, built so the source stays readable unrendered.
Observed requests

Share of eligible sites where each crawler requested this file at least once, over the 90 days to 12 November 2026.

Markdown: observed requests by crawler
CrawlerEvidenceSites with a requestMedian requests per site per dayRank
OAI-SearchBotEstablished patternunder 5%0Similar to others
ChatGPT-UserEstablished patternunder 5%0Similar to others
GPTBotEstablished patternunder 5%0Similar to others
Claude-UserEstablished patternunder 5%0Similar to others
ClaudeBotEstablished patternunder 5%0Similar to others
PerplexityBotEstablished patternunder 5%0Similar to others
bingbotEstablished patternunder 5%0Similar to others
ApplebotEstablished patternunder 5%0Similar to others
Meta-ExternalAgentEstablished patternunder 5%0Similar to others
AmazonbotEstablished patternunder 5%0Similar to others
Claude-SearchBotEstablished pattern0%0Similar to others
Claude-WebEstablished pattern0%0Similar to others
anthropic-aiEstablished pattern0%0Similar to others
Perplexity-UserEstablished pattern0%0Similar to others
Google-CloudVertexBotEstablished pattern0%0Similar to others
GooglebotEstablished pattern0%0Similar to others
Meta-ExternalFetcherEstablished pattern0%0Similar to others
FacebookBotEstablished pattern0%0Similar to others
CCBotEstablished pattern0%0Similar to others
BytespiderEstablished pattern0%0Similar to others
DuckAssistBotEstablished pattern0%0Similar to others
MistralAI-UserEstablished pattern0%0Similar to others
cohere-aiEstablished pattern0%0Similar to others
YouBotEstablished pattern0%0Similar to others
DiffbotEstablished pattern0%0Similar to others
TimpibotEstablished pattern0%0Similar to others
PetalBotEstablished pattern0%0Similar to others

Figures are rounded and cover only sites that served the file for the whole window. Requests are to Geordy-served files, identified by user agent; a request is not evidence of use or citation. Pairs with too few independent sites are not shown. See how we measure.

Other core formats

Generate every format at once.

Geordy emits 8 formats on every plan and 16 on Growth, auto-selected per page type and live on Geordy the moment they are written.

Markdown (.md) format - spec, examples and AI readers | Geordy