linkContents

Reports links with empty URLs or only empty fragments.

✅ This rule is included in the md logical preset.

Markdown syntax can make it difficult to easily see that you’ve forgotten to give a link a destination. This is especially true when writing prose in Markdown, where you may intend to create a link but leave the destination for later and then forget to go back and add it. A link with an empty URL or only an empty fragment (#) results in broken or non-functional links.

Examples

❌ Incorrect

[Flint]()

[Skip to Content](#)

[Link text]()

✅ Correct

[Flint](https://flint.fyi)

[Skip to Content](#content)

[Link](./page.html)

When Not To Use It

If you intentionally use empty link URLs as placeholders and have a framework or other workflow that always fills them in later, you might want to disable this rule.

Further Reading

• Markdown Links Syntax

Equivalents in Other Linters

• ESLint: markdown/no-empty-links
• Markdownlint: no-empty-links