Setu - CLI Markdown Link Checker

setu scans your documentation, extracts links, and validates both local file paths and remote URLs concurrently so your docs never suffer from bit rot or broken pathways.

Motivation

After working on countless projects that all use markdown I find myself running into the same issue, are all my links valid? A simple typo could redirect users to a dead website or a missing asset and these issues are often caught too late; in production.

Installation:

Using cargo:

cargo install setu-cli

Usage:

Usage: setu-cli [OPTIONS] [TARGET_PATH]

Arguments:
  [TARGET_PATH]  [default: .]

Options:
  -s, --strict
  -h, --help     Print help
  -V, --version  Print version

Examples:

Use setu to scan the current directory in strict mode

setu-cli -s

To scan a different directory type its path:

setu-cli ./docs

Concerns Argument

Setu treats remote URL's as OK if something is returned from them, even if thats a 404, because the site is still reachable. You can flag specific response codes as concerns using the --concerns argument:

setu-cli --concerns 404,500

For example under these rules:

404 - Faulty

401 - Valid

500 - Faulty

CI Examples

To use this as part of your CI see the workflow used by this repository.

When running setu-cli as part of your CI, you should run it in --strict mode to terminate the program with exit code 1.

📄 License

This project is licensed under the MIT License