README Analyzer BETA
Analyze your README for structure, completeness and best practices. Paste Markdown or point us at a repository.
Rule-based, repeatable, local
Heuristics you can predict
Sections are detected from headings and well-known cues; the score is a fixed weighting of those sections plus a handful of structure checks. Links are counted, never requested, so this tool never claims a link is broken or alive. Nothing is analyzed by a third-party AI service, and no repository content is retained after the report is built.
FAQ
My README is good but scores low. How?
The score rewards a predictable structure, because that is what a stranger navigates by. A brilliant document with no installation heading still costs a newcomer time, and that is what the missing section reports.
Are the links checked?
No. They are counted so the structure checks can see whether the document links out at all. Nothing is requested, so nothing here says a link works or is broken.
Is my code or README sent to an AI service?
No. The analysis is a deterministic parser on our own server. The text is read, scored and discarded.
Can I analyze a private repository?
Not by URL, since the fetch is unauthenticated. Paste the Markdown instead: it is processed in exactly the same way.
Want polished docs and developer experience?
We help teams ship clear documentation and better digital products.




