AsciiDoc处理器将在应用宏替换步骤的任何地方检测到常见的URL（除非被转义）并自动将它们转换为链接。本页面记录了被识别的URL方案以及如何在特定情况下禁用此行为。

自动链接的URL方案

AsciiDoc 在不需要任何标记的情况下识别以下常见的 URL 方案：

  • 超文本传输协议

  • 超文本传输安全协议

  • 文件传输协议

  • 互联网中继聊天

  • 电子邮件地址

在下面的示例中，URL以一个已识别的协议（即https）开头，因此AsciiDoc处理器会自动将其转换为超链接。

Unresolved directive in autolinks.adoc - include::example$url.adoc[tag=base-co]

  1. 尾随的句号不会被链接捕获。

URL同时也被用作链接文本。如果你想使用自定义链接文本，你必须使用URL宏。

在纯文本文档中，一个裸露的URL通常被尖括号包围。

你经常会在示例中看到<https://example.org>被使用。

为了适应这一惯例，AsciiDoc处理器仍将识别URL作为自动链接，但在输出中将丢弃尖括号（因为它们不被视为重要的）。

任何从纯URL（即自动链接）创建的链接都会自动被分配“bare”角色。这允许主题系统（例如，CSS）识别自动链接（以及其他纯URL）并以不同的方式对其进行样式设计。

电子邮件自动链接

AsciiDoc还能检测并自动链接大多数电子邮件地址。

Unresolved directive in autolinks.adoc - include::example$url.adoc[tag=bare-email]

为了使这个工作正常进行，域名后缀必须是2到5个字符（例如，.com），并且只允许使用常见符号，如点号（.）、连字符（-）和加号（+）。对于不符合这些限制的电子邮件地址，您可以使用电子邮件宏。

转义URL和电子邮件地址

为了防止URL或电子邮件地址自动链接，你可以在它前面加上一个反斜杠（\）。

一旦启动，该网站将可以通过 \https://example.org 访问。

如果你无法访问该网站，请通过电子邮件\help@example.org寻求帮助。

URL和电子邮件地址前面的反斜杠在输出中不会显示。URL和电子邮件地址都将以纯文本形式显示。

自动链接是宏替换的一个功能，阻止URL或电子邮件地址自动链接的另一种方法是使用增量替换关闭宏替换。

一旦启动，该网站将可以通过 https://example.org 访问。

subs` 属性只能在叶子块上被识别，例如一个段落。