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
Read byGPTBotClaudeBotPerplexityBotGeneral LLM systems
Other core formats