bareUrls
Reports bare URLs that should be formatted as autolinks or links.
✅ This rule is included in the md stylistic
preset.
Bare URLs without angle brackets are not universally recognized as clickable links across all Markdown processors.
While GitHub Flavored Markdown supports bare URLs, standard Markdown requires them to be wrapped in angle brackets (<>
) or formatted as links with descriptive text.
Using proper formatting ensures compatibility and improves accessibility.
Examples
Section titled “Examples”For more info, visit https://www.example.com
Contact us at user@example.com
# https://www.example.com/
For more info, visit <https://www.example.com>For more info, visit [Example Website](https://www.example.com)
Contact us at <user@example.com>Contact us at [user@example.com](mailto:user@example.com)
# <https://www.example.com/>
Not a clickable link: `https://www.example.com/`
When Not To Use It
Section titled “When Not To Use It”If you know your project is only going to be used with a particular Markdown parser, and that parser supports bare URLs predictably, you might not need this rule.
Further Reading
Section titled “Further Reading”Equivalents in Other Linters
Section titled “Equivalents in Other Linters”- ESLint:
markdown/no-bare-urls
Made with ❤️🔥 in Boston by
Josh Goldberg and contributors.