Show HN: Find Markdown files in your repo that aren't linked from the README

1 point

3 months ago

Most repos accumulate .md files that nobody ever reads — CONTRIBUTING.md, ARCHITECTURE.md, docs/API.md — because they were never linked from the root README. They exist but are invisible to anyone navigating the project.

I built a small CLI tool that scans a repo, checks which .md files are actually referenced in the root README, and reports the rest as "isolated". It also has an interactive fix option that appends the missing links directly into your README, and a GitHub Action if you want to enforce it in CI.

Single Python file, no config, runs offline. Would love feedback on whether the approach makes sense or if there are edge cases I haven't considered.