markdown 语法中的 bare url

2025/06/22

一、背景

今天在用格式化工具对 markdown 文章处理时,发现文章中的链接两侧被加上了<>符号,一开始还以为是异常,但其实是一种包裹的结构。

裸 URL 可能破坏文档结构,建议用 < > 包裹或嵌入链接文本。

二、示例

错误场景(裸 URL 可能被误解析)

请访问 https://example.com. 了解更多 → 解析器可能将末尾的句号包含进 URL

安全写法

请访问 <https://example.com>. 了解更多 → 句号明确排除在 URL 外

为何脚注定义需要此优化? 脚注定义 ([^1]: …) 中的 URL 通常是独立存在的(没有描述文本包裹),属于裸 URL 的高风险场景。优化为 <https://...> 能确保:

任何 Markdown 解析器(如 GitHub、Obsidian、VSCode)均正确识别完整 URL。

避免 URL 中的特殊字符(如 _, ~, #)干扰渲染。