MD034- 使用裸网址
标签:links,url
别名:no-bare-urls
可修复:一些违规行为可以通过工具修复
单纯的链接地址需要用尖括号 (<>) 包裹,否则有些解释器不会解释为链接
只要出现没有尖括号的 URL 或电子邮件地址,就会触发此规则:
For more info, visit https://www.example.com/ or email user@example.com.
要解决此问题,请在 URL 或电子邮件地址两侧添加尖括号:
For more info, visit <https://www.example.com/> or email <user@example.com>.
注意:要包含裸 URL 或电子邮件而不将其转换为链接,请将其包装在代码范围中:
Not a clickable link: `https://www.example.com`
注意:以下场景不会触发此规则,因为它可能是快捷链接:
[https://www.example.com]
注意:以下语法会触发此规则,因为嵌套链接可能是快捷方式链接(优先):
[text [shortcut] text](https://example.com)
为了避免这种情况,请转义两个内括号:
[link \[text\] link](https://example.com)
理由:如果没有尖括号,裸露的 URL 或电子邮件不会被某些 Markdown 解析器转换为链接。