https://github.com/step-security/linkinator-action
A GitHub Action that checks your README and other markdown for 404s. Secure drop-in replacement for JustinBeckwith/linkinator-action.
https://github.com/step-security/linkinator-action
step-security-maintained-actions
Last synced: 11 days ago
JSON representation
A GitHub Action that checks your README and other markdown for 404s. Secure drop-in replacement for JustinBeckwith/linkinator-action.
- Host: GitHub
- URL: https://github.com/step-security/linkinator-action
- Owner: step-security
- License: mit
- Created: 2025-04-23T06:15:00.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-08T05:26:05.000Z (27 days ago)
- Last Synced: 2026-05-08T07:36:16.135Z (27 days ago)
- Topics: step-security-maintained-actions
- Language: JavaScript
- Homepage: https://docs.stepsecurity.io/actions/stepsecurity-maintained-actions
- Size: 2.28 MB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://docs.stepsecurity.io/actions/stepsecurity-maintained-actions)
# linkinator-action
> A happy little GitHub Action that checks your README.md and other markdown for broken links.
## Example usage
With no arguments, this will scan your `README.md` in the root of the GitHub repository:
```yaml
on:
push:
branches:
- main
pull_request:
name: ci
jobs:
linkinator:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: step-security/linkinator-action@v1
```
Or you can do below
```yaml
on:
push:
branches:
- main
pull_request:
name: ci
jobs:
linkinator:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: step-security/linkinator-action@v1
with:
paths: test/fixtures/test.md
concurrency: 1
markdown: true
linksToSkip: "http://fake.local, http://fake.local/fake"
```
## Inputs
- `paths` - Paths to scan for 404s. Defaults to `*.md`.
- `config` - Path to a config file to use. Looks for `linkinator.config.json` by default. Options defined via the GitHub Action config will take precedence.
- `concurrency` - The number of connections to make simultaneously. Defaults to `100`.
- `recurse` - Recursively follow links on the same root domain. Defaults to `false`.
- `linksToSkip` - List of urls in regexy form to not include in the check. (`skip` is also accepted)
- `timeout` - Request timeout in ms. Defaults to 0 (no timeout).
- `markdown` - Automatically parse and scan markdown if scanning from a location on disk. Defaults to `true`.
- `serverRoot` - When scanning a local directory, customize the location on disk where the server is started. Defaults to the root of your GitHub repository.
- `directoryListing` - Include an automatic directory index file when linking to a directory. Defaults to `false`.
- `retry` - Automatically retry requests that return HTTP 429 responses and include a `retry-after` header.
- `urlRewriteSearch` - Pattern to search for in urls. Must be used with `urlRewriteReplace`.
- `urlRewriteReplace` - Expression used to replace search content. Must be used with `urlRewriteSearch`.
- `verbosity` - Override the default verbosity for this command. Available options are "DEBUG", "INFO", "WARNING", "ERROR", and "NONE". Defaults to "WARNING".
## Outputs
- `results` - An object with the results of the run.
## Debugging
To view skipped links, failure details, and more debugging information [enable step debug logging](https://docs.github.com/en/free-pro-team@latest/actions/managing-workflow-runs/enabling-debug-logging#enabling-step-debug-logging).
## License
[MIT](LICENSE)