norberttech / md-link-linter
Markdown link linter
Requires
- php: ~8.1.0
- ext-dom: *
- ext-mbstring: *
- cocur/slugify: ^3.2 || ^4.0
- erusev/parsedown: ^1.7
- psr/log: ^1.1 || ^2.0 || ^3.0
- symfony/console: ^3.4||^4.4||^5.0||^6.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.9
- phpstan/phpstan: ^1.8
- phpunit/phpunit: ^9.5 || ^10.0
README
Simple command line tool that aims to detect invalid links in markdown files.
Currently following types of links are being validated:
- relative links
- anchor links
- mention links
bin/mdlinklint path --exclude=vendor --exclude=node_modules
Use with Docker:
docker run -t --rm -v $PWD:/app norberttech/md-link-linter --exclude=vendor --exclude=node_modules .
First argument path
can be skipped or overwritten by environment variable MD_LINTER_SCAN_DIR
MD_LINTER_SCAN_DIR=path bin/mdlinklint --exclude=vendor --exclude=node_modules
When both, argument path and environment variable are present, environment variable takes priority.
./mdlinklint --help Usage: run [options] [--] [<path>] Arguments: path Path in which md link linter should validate all markdown files Options: --dry-run Scan path and output md files --exclude=EXCLUDE Exclude folders with this name (multiple values allowed) --mention=MENTION Mentions whitelist (can include all team members or groups), if empty mentions are not validated (multiple values allowed) -h, --help Display help for the given command. When no command is given display help for the run command -q, --quiet Do not output any message -V, --version Display this application version --ansi Force ANSI output --no-ansi Disable ANSI output -n, --no-interaction Do not ask any interactive question -bf, --break-on-failure Break the inspection on first failure -rp, --root-path=ROOT-PATH Root path used to assert absolute links. Link: [link](/nested/file.php) will check if file /nested/file.php exists from this path -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Validating mentions
Using --mention
option you can set allowed mentions
bin/mdlinklint path --mentions=norberttech --mention=team_name
If not used, mention link assertion will always pass.
Installation
Docker
Recommended - md-link-linter is not a type of tool you want to put into your project as a dependency because it comes with it own dependencies that might overlaps with yours.
Docker Hub - norberttech/md-link-linter
Composer
composer global require norberttech/md-link-linter
Phive
Since md-link-linter relay on \realpath
function which does not work in Phar environment (explanation below)
there are no plans for now to make it available through phive.
The function realpath() will not work for a file which is inside a Phar as such path would be a virtual path, not a real one.
php.net realpath documentation
Development
Install dependencies
composer install
Run tests
composer tests
Codding standards
This command might change your code!
composer cs:php:fix