Nimble Pixie Merchant


    1.1.0 • Public • Published


    remark-lint plugin to ensure that external URLs in your Markdown are alive.

    NPM Build Status

    Checks all of the following:

    Checks [links](
    Checks images: ![horse](/path/to/horse.jpg)
    Checks definitions: see the [walrus].
    [walrus]: /path/to/walrus.jpg

    Uses check-links to check URLs for liveness.

    A few details to keep in mind:

    • By default, relative URLs are skipped. To check relative URLs, set gotOptions.baseUrl (see below).
    • Ignores absolute URLs with protocols other than http: and https:.
    • check-links memoizes results, so on any given run each URL will only be pinged once; subsequent checks will be returned from the cache.


    Use like any other remark-lint plugin. Check out the remark-lint documentation for details.


    All options are optional. The options object may contain any of the following properties:

    • skipOffline {boolean} - Default: false. By default, if you are offline when you run the check you will receive a warning. If you want to let offline runs quietly pass, set this option to true.
    • skipLocalhost {boolean} - Default: false. By default, localhost links are treated the same as other links, so if your project is not running locally you'll receive a warning. If you want to ignore localhost links (e.g. http://localhost/*,*), set this option to true.
    • skipUrlPatterns {Array} - Array of String | RegExp. A list of patterns for URLs that should be skipped. Each URL will be tested against each pattern, and will be ignored if new RegExp(pattern).test(url) === true. For example, with skipUrls: [/^http:\/\/(.*)url-to-ignore\.com/, ''], links with the URLs and will not be checked.
    • gotOptions {Object} - Passed through check-links to Got. See documentation for Got options. With these options, you can customize retry logic, specify custom headers, and more. Here are some specific Got options that you might want to use:
      • gotOptions.baseUrl {string} - Used as the base URL against which relative URLs are checked. By default, relative URLs are ignored: you must provide this option to check them. For example, with baseUrl: '', the relative URL /davidtheclark is checked as
      • gotOptions.concurrency {number} - Maximum number of URLs to check concurrently (default 8).


    When this rule is turned on, the following is ok:

    Here is a [good link](

    When this rule is turned on, the following is not ok:

    Here is a [bad link](
    1:11-1:68: Link to is dead

    By default, relative links are ignored. To check relative links, you must provide gotOptions.baseUrl as an option.

    When nothing is passed, the following is ok:

    Here is a [good relative link](wooorm/remark)
    Here is a [bad relative link](wooorm/remark-dead-link)

    When is passed in, the following is ok:

    Here is a [good relative link](wooorm/remark)

    But the following is not ok:

    Here is a [bad relative link](wooorm/remark-dead-link)


    npm i remark-lint-no-dead-urls

    DownloadsWeekly Downloads






    Unpacked Size

    15.7 kB

    Total Files


    Last publish


    • davidtheclark
    • fisch0920