Markdown链接生成器

输入链接URL和锚文本后,生成器将输出规范的Markdown链接格式([text](url)),并可选添加标题工具提示以及参考样式变体(使URL脱离段落)。此功能特别适用于复制包含追踪参数的长URL时,既能保持段落可读性,又不会破坏链接显示效果。

如何生成Markdown链接

  1. 1

    粘贴网址

    绝对或相对路径。该工具会将空格和保留字符进行 URL 编码。

  2. 2

    输入锚文本

    读者所看到的可点击文本。

  3. 3

    添加标题(可选)

    在大多数渲染器中,悬停时会显示。

  4. 4

    选择样式

    根据下方定义,采用内嵌式 `[text](url)` 或引用式 `[text][ref]`。

  5. 5

    复制并粘贴

    一键复制到您的文档或 README 文件中。

四种链接变体

内联,无标题:

[Read the docs](https://example.com/docs)

与标题同行(悬停提示):

[Read the docs](https://example.com/docs "Full documentation")

引用样式(URL如下所示):

Open the [docs][docs] or the [changelog][cl].

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

自动链接(URL 同时包含文本和目标地址):

<https://example.com>

何时选择哪一项?

  • 内嵌式:适用于偶尔使用的链接,当URL较短且段落内容仍易于阅读时。
  • 引用样式:用于多次引用同一URL时,或当URL长度超过200个字符(可能导致段落结构混乱)时。
  • 自动链接:适用于“这是我们的文档页面”这类场景,可让您将URL同时以文本形式和实际链接地址的形式显示。

特殊字符的卫生处理

  • URL 中的空格需使用 %20 格式,否则链接会在空格处中断。
  • URL中的括号需使用URL编码格式(如%28%29),否则Markdown解析器将无法正确处理。
  • 锚文本中的方括号必须以 \[\] 的格式进行转义,以防止解析器将其识别为嵌套链接语法。

可访问性提示

  • 避免使用“点击此处”等标题文本。像 click hereread more 这样的锚文本在屏幕阅读器用户逐项浏览链接时毫无用处,请使用描述性文本,例如 [installation guide](...)
  • 对于较长的URL,切勿将URL本身作为锚文本,这既不利于辅助技术功能,又在印刷版中效果不佳。
  • “在新标签页中打开”为原始HTML(target="_blank"),而非Markdown格式。大多数支持原始HTML的渲染器都能正确处理该格式,而纯CommonMark格式则无法支持。

单行快捷方式

在 GitHub 评论中,将 URL 粘贴到选中的文本旁边即可自动将其转换为 Markdown 链接。当你已处于编辑器时非常实用。

常见问题

不行。target="_blank" 需要原始 HTML 格式;大多数 Markdown 渲染器均支持 HTML 备用格式 <a href="..." target="_blank" rel="noopener">text</a>

这些内容仅作为桌面浏览器中的悬停提示显示。大多数屏幕阅读器无法识别它们,触摸设备上也会忽略这些提示,因此请勿在此处放置关键信息。

当同一URL多次出现、URL较长(如跟踪参数或UUID)时,或需要将所有链接集中显示在文档底部以便于维护时。

是的,在大多数渲染器中,[other doc](./other.md) 都会链接到同一目录下的另一个文件。不同平台(如 GitHub、Obsidian 或静态网站生成器)的表现可能有所差异,请在目标环境中进行测试。

相关工具

此工具还提供其他语言版本