HyperHawk Link Checker

A GitHub Action that scans your markdown files for broken links and reports them directly on pull requests as inline review comments, including one-click suggestions to fix them.

• Checks internal links (relative and root-relative paths) by verifying the file exists on disk
• Checks same-org GitHub links via the GitHub API, including file existence and blob/tree correctness
• Checks external HTTP/HTTPS links with redirect following, timeout, and bot-detection avoidance
• Suggests fixes: corrected paths for moved files (exact and fuzzy match), root-relative conversions, updated redirect targets, branch name updates, and blob/tree corrections
• On pull requests: posts inline review comments with suggestion blocks you can apply in one click
• On push / schedule: writes a summary table and emits warning annotations
• Never fails the workflow unless you opt in to strict mode

• Configuration - strict mode, ignore patterns, scanning scope
• How it works - link classification, PR review behaviour, permissions
• Cross-repo access - checking links into private repositories
• Workflow examples - common workflow configurations
• Troubleshooting - common issues and solutions

.github/workflows/link-check.yml

name: Hyperhawk

on:
  pull_request:
  push:
    branches: [main]
  schedule:
    - cron: '0 0 * * 1'   # every Monday at midnight

jobs:
  link-check:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write

    steps:
      - uses: actions/checkout@v4

      - uses: dvdstelt/hyperhawk@v1
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

Need to check links into private repositories in the same org? See Cross-repo access.