Skip to content

๐Ÿ”— Action: Link Checker

Maintain a high-quality documentation site by automatically detecting and reporting broken links.


[!TIP] Use the Link Checker as part of your documentation CI to ensure that every link in your docs/ and READMEs remains valid, preventing the frustration of "404 Not Found" for your users.

๐Ÿš€ Key Impact

  • ๐Ÿ” Comprehensive Scanning: Recursively checks Markdown and HTML files for broken internal and external links.
  • ๐Ÿ› ๏ธ Flexible Filtering: Use glob patterns to focus the scan on specific documentation directories.
  • ๐Ÿ›‘ Failure Guardrails: Configure the action to fail the build if any broken links are detected.

โš™๏ธ Configuration

Input Required Default Description
search-path No **/*.md Glob pattern to find files to scan.
fail-on-error No true Whether to fail the build on broken links.

โšก Quick Start

- name: ๐Ÿ”— Check Documentation Links
  uses: carlos-camara/qa-hub-actions/link-checker@main
  with:
    search-path: "docs/**/*.md"

[View Full Wiki](https://carlos-camara.github.io/qa-hub-actions/actions/link-checker/)