REPOGEO REPORT · LITE

waynesutton/markdown-site

Default branch main · commit 3872c59b · scanned 6/6/2026, 11:12:47 AM

GitHub: 616 stars · 90 forks

AI VISIBILITY SCORE

27 /100

Critical

Category recall

0 / 2

Not recommended in any query

Rule findings

2 pass · 0 warn · 0 fail

Objective metadata checks

AI knows your name

1 / 3

Direct prompts that named your repo

HOW TO READ THIS REPORT

Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface waynesutton/markdown-site, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.

Action plan — copy-paste fixes

3 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.

OVERALL DIRECTION

highreadme#1

Reposition README H1 and opening paragraph

Why:

CURRENT

# markdown "sync" framework

An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex.

COPY-PASTE FIX

# markdown-site: Real-time Publishing Framework for AI Agents & Developers

An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs. Write markdown, sync from the terminal, and your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify, it offers real-time content updates without redeploying.

mediumtopics#2

Expand repository topics for better categorization

Why:

CURRENT

cms, convex, markdown, open-source, sync

COPY-PASTE FIX

ai-agents, llm-discovery, realtime-publishing, content-framework, cms, convex, markdown, open-source, sync

mediumreadme#3

Add a 'Why markdown-site?' comparison section to README

Why:

COPY-PASTE FIX

## Why markdown-site?
Unlike traditional static site generators (like MkDocs or Jekyll) that require a full rebuild and redeploy for every content change, markdown-site offers instant, real-time content updates. It's specifically designed for AI agent and LLM discovery, leveraging Convex for real-time data synchronization, making your content immediately available to browsers and AI systems without manual intervention or complex CI/CD pipelines. It's not just a file sync tool; it's a dynamic publishing platform.

Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash

Category visibility — the real GEO test

Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?

Same questions for every model — switch tabs to compare answers and rankings.

Recall

0 / 2

0% of queries surface waynesutton/markdown-site

Avg rank

—

Lower is better. #1 = top recommendation.

Share of voice

Of all named tools, what % are you?

Top rival

Netlify CMS

Recommended in 1 of 2 queries

COMPETITOR LEADERBOARD

Netlify CMS · recommended 1×
GitHub Pages · recommended 1×
GitLab Pages · recommended 1×
Contentful · recommended 1×
Strapi · recommended 1×

CATEGORY QUERY
How to instantly publish markdown content for websites or documentation without redeploying?
you: not recommended
AI recommended (in order):
1. Netlify CMS
2. GitHub Pages
3. GitLab Pages
4. Contentful
5. Strapi
6. Sanity.io
7. Notion
8. react-notion-x
9. notion-client
10. GitBook
11. Read the Docs
AI recommended 11 alternatives but never named waynesutton/markdown-site. This is the gap to close.
Show full AI answer
CATEGORY QUERY
What open-source framework helps developers publish markdown for AI agents via terminal sync?
you: not recommended
AI recommended (in order):
1. MkDocs
2. mkdocs-material
3. rsync
4. scp
5. Jekyll
6. Hugo
7. Docusaurus
8. Sphinx
9. MyST-Parser
10. git
AI recommended 10 alternatives but never named waynesutton/markdown-site. This is the gap to close.
Show full AI answer

Objective checks

Rule-based audits of metadata signals AI engines weight most.

Metadata completeness
pass
README presence
pass

Self-mention check

Does AI even know your repo exists when asked about it directly?

Compared to common alternatives in this category, what is the core differentiator of waynesutton/markdown-site?
pass
AI did not name waynesutton/markdown-site — likely talking about a different project
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
If a team adopts waynesutton/markdown-site in production, what risks or prerequisites should they evaluate first?
pass
AI named waynesutton/markdown-site explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
In one sentence, what problem does the repo waynesutton/markdown-site solve, and who is the primary audience?
pass
AI did not name waynesutton/markdown-site — likely talking about a different project
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

Embed your GEO score

Drop this badge into the README of waynesutton/markdown-site. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.

Live preview

MARKDOWN (README)

[![RepoGEO](https://repogeo.com/badge/waynesutton/markdown-site.svg)](https://repogeo.com/en/r/waynesutton/markdown-site)

HTML

<a href="https://repogeo.com/en/r/waynesutton/markdown-site"><img src="https://repogeo.com/badge/waynesutton/markdown-site.svg" alt="RepoGEO" /></a>

Pro

Subscribe to Pro for deep diagnoses

waynesutton/markdown-site — Lite scans stay free; this card itemizes Pro deep limits vs Lite.

Deep reports10 / month
Brand-free category queries5 vs 2 in Lite
Prioritized action items8 vs 3 in Lite