45 строки
1.9 KiB
Markdown
45 строки
1.9 KiB
Markdown
# 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](./images/working.gif)
|
|
|
|
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](./images/install.gif)
|
|
|
|
## 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.
|
|
|