This package allows to check either a link points to the existing resource.
Last updated 4 years ago by sobolevn .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install remark-lint-are-links-valid 
SYNC missed versions from official npm registry.


Build Status Coverage Status

This rule checks every link in your Markdown file to point to the existing resource. There are also different options to configure.

Inspired by awesome_bot.

Using the rule

Via .remarkrc

npm install -g remark
npm install -g remark-lint
npm install remark-lint-are-links-valid # local install!

Then, set up your .remarkrc:

  "plugins": {
    "remark-lint": {
      "external": ["remark-lint-are-links-valid"]

Now you can use the following command to run the lint:

remark --no-stdout

Using different options

Set up your .remarkrc:

  "plugins": {
    "remark-lint": {
      "external": ["remark-lint-are-links-valid"],
      "are-links-valid": {
        "allowDuplicates": false,
        "whiteListDomains": [""],

        "allowErrors": [301],
        "allowRedirects": true,
        "timeout": 10000,


  • allowDuplicates, defaults to true, if set to false checks for each domain to be unique on the page, some domains can be whitelisted by the whiteListDomains option.
  • whiteListDomains, defaults to [], if both allowDuplicates is set to false and it is set to any array containing string domains, will not raise any warnings when there are multiple urls for the same domain on the single page.
  • allowErrors, defaults to [], when the link is validated it is expected to have the HTTP status code 2XX, this setting allows to add any other numeric values.
  • allowRedirects, defaults to true, when set to false will not follow any redirects from the linked resource.
  • timeout, defaults to 5000, change this value to set the desired timeout for the request.


npm install -g remark
npm install -g remark-lint
npm install -g remark-lint-are-links-valid # global install!
remark --no-stdout -u remark-lint="external:[\"remark-lint-are-links-valid\"]"

Note that the lint=<lint_options> option only works with remark >= 1.1.1.




MIT, see for details.

This is based on this one by @chcokr (MIT).

Current Tags

  • 1.0.3                                ...           latest (4 years ago)

4 Versions

  • 1.0.3                                ...           4 years ago
  • 1.0.2                                ...           4 years ago
  • 1.0.1                                ...           4 years ago
  • 1.0.0                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (8)
Dev Dependencies (13)

Copyright 2014 - 2017 © |