check-links

Check for broken external and internal links in your content files.

hwaro tool check-links

# Output result as JSON
hwaro tool check-links --json

# Custom timeout and concurrency
hwaro tool check-links --timeout 30 --concurrency 4

# Check only external or internal links
hwaro tool check-links --external-only
hwaro tool check-links --internal-only

Options

Flag	Description
-c, --content-dir DIR	Content directory (default: `content`)
--timeout SECONDS	HTTP request timeout in seconds (default: 10)
--concurrency N	Max concurrent requests (default: 8)
--external-only	Check external links only
--internal-only	Check internal links only
-j, --json	Output result as JSON
-h, --help	Show help

How It Works

Scans all Markdown files in the content/ directory
Finds external URLs (http/https links) and internal links (relative/absolute paths)
Sends concurrent HEAD requests to external URLs
Verifies internal link targets exist on disk (checks .md, _index.md, index.md)
Reports broken or unreachable links

Link Types

Type	Description
External	`http://` and `https://` links — checked via HTTP HEAD
Internal	Relative and absolute path links — checked on filesystem
Images	`![alt](path)` image references — checked on filesystem

Example Output

Starting dead link check in 'content'...
----------------------------------------
✘ Found 3 dead links (out of 50 total):
[DEAD] content/blog/post.md
  └─ URL: https://old-site.com/page
  └─ Status: 404
[DEAD] content/blog/post.md
  └─ URL: ../missing-page (internal)
  └─ Internal link target not found
[DEAD] content/about.md
  └─ URL: /images/photo.png (internal)
  └─ Image not found
----------------------------------------

JSON Output

{
  "dead_links": [
    {
      "link": {
        "file": "content/blog/post.md",
        "url": "https://old-site.com/page",
        "kind": "external"
      },
      "status": 404,
      "error": null
    },
    {
      "link": {
        "file": "content/about.md",
        "url": "/images/photo.png",
        "kind": "image"
      },
      "status": -1,
      "error": "Image not found"
    }
  ],
  "total_links": 50,
  "external_links": 30,
  "internal_links": 20,
  "dead_link_count": 2
}