DeadLinkFinder Catches Broken Markdown Links and Anchors

Project documentation quietly rots over time. Renaming a file, refactoring section headings in a README.md, or moving diagrams to a new folder frequently results in broken relative links and invalid heading anchors. Code reviews rarely catch these issues because reviewers rarely manually click every single link and table-of-contents anchor across every pull request.

To solve this, Umut Güngör developed DeadLinkFinder, a fast, zero-dependency Python CLI tool that verifies local Markdown links, image assets, GitHub-flavored heading anchors, and optional external URLs before they reach production environments.

When searching for a suitable link linter, developers often encounter common hurdles such as bloated external dependencies or a lack of proper anchor validation. DeadLinkFinder avoids these issues by relying exclusively on the Python standard library—specifically re, pathlib, difflib, and urllib—resulting in zero external dependencies to audit or maintain.

Stock photo for illustration only, not from the actual event

Users can install the tool easily via pip install deadlinkfinder and run it against any directory or Markdown file using commands like deadlinkfinder docs/ README.md. The terminal output clearly pinpoints errors and provides intelligent suggestions, such as suggesting '../guides/install-setup.md' when a target file like '../guides/setup.md' cannot be found.