Skip to content
This repository has been archived by the owner on May 9, 2024. It is now read-only.

microsoft/linkcheckermd

Repository files navigation

LinkCheckMD

Load a Markdown file and get highlights and hovers for links that contain a country code (en-us for example.)

If you use Alt+L, it will generate a report on the links in the document, including broken links. It attempts to check broken links by trying to resolve HTTP & HTTPS links, and relative links (../folder/file.md) by checking if the file exist on the local file system. The result of these checks are logged in an output window on the right of the editor.

Animated GIF of URLs being flagged as warnings and Alt+L functionality

Note that checking for broken links is more of an art than a science. Some sites don't actually return 404, but send you to a landing page. For example, Azure.com works this way. You can go to https://Azure.com/foo/bar and it will happily redirect you to https://Azure.com, with no 404 status returned. So take a status of "OK" with a grain of salt - you may not be arriving at the page you intend.

Install

Open Visual Studio Code and press F1; a field will appear at the top of the window. Type ext install linkcheck, hit enter, and reload the window to enable.

Animated GIF of installing the extension

Rules

LNK0001: Check for country code

This rule checks links for language identifiers, such as en-us.

Check for broken links

To check for broken links, use Alt+L. This will open a new column to the right of the VSCode window and display the status of the links as they are checked.

Changes

0.3.0

  • Added configuration setting to disable the country code rule

0.2.0

  • Fixed a bug preventing links with parentheses from being correctly parsed

0.1.5

  • Added country code warnings to the output window for Alt+L checking
  • Updated vscode dependency for the latest version

TODO

  • Refactor broken link checking to display the actual URL that you arrived at for "OK" results that were redirects to a different URL.

About

A VSCode extension that check links in Markdown to ensure they are valid.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published