[GH-ISSUE #586] Add rule to check relative links #2311

New issue

Closed

opened 2026-03-07 20:06:35 +03:00 by kerem · 2 comments

kerem commented

2026-03-07 20:06:35 +03:00

Owner

Originally created by @koenigst on GitHub (Sep 23, 2022).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/586

Use case

Check relative link to files
Check anchors in relative linked files (this would be an extension to MD051).

Example

Files:

contributing.md
image.png
readme.md

Content readme.md:

# Heading
![image](image.png)
[link to anchor](contributing.md#Heading)

Details

The logic for discovering relative files could be similar to textlint-rule-no-dead-link.

Originally created by @koenigst on GitHub (Sep 23, 2022). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/586 ### Use case * Check relative link to files * Check anchors in relative linked files (this would be an extension to [`MD051`](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md051)). ### Example Files: ``` contributing.md image.png readme.md ``` Content `readme.md`: ``` # Heading ![image](image.png) [link to anchor](contributing.md#Heading) ``` ### Details The logic for discovering relative files could be similar to [textlint-rule-no-dead-link](https://github.com/textlint-rule/textlint-rule-no-dead-link#relative-link-resolution).

kerem

2026-03-07 20:06:35 +03:00

closed this issue
added the
new rule
label

kerem commented

2026-03-07 20:06:36 +03:00

Author

Owner

@vorburger commented on GitHub (Mar 12, 2023):

#121 seems related to / a duplicate of this? (TL;DR https://github.com/Divlo/markdownlint-rule-relative-links is a plugin, and https://github.com/tcort/markdown-link-check/ a separate alternative.)

@vorburger commented on GitHub (Mar 12, 2023): #121 seems related to / a duplicate of this? (TL;DR https://github.com/Divlo/markdownlint-rule-relative-links is a plugin, and https://github.com/tcort/markdown-link-check/ a separate alternative.)

kerem commented

2026-03-07 20:06:36 +03:00

Author

Owner

@DavidAnson commented on GitHub (Mar 12, 2023):

Agree, I will close this. Please add any missing details to that issue.

@DavidAnson commented on GitHub (Mar 12, 2023): Agree, I will close this. Please add any missing details to that issue.