链接

要创建内嵌链接,请在链接文本的右方括号后面使用一对圆括号。在圆括号内添加您要指向的链接网址,以及用引号括起来的链接标题(可选)。例如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

将生成:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

如果您引用的是同一服务器上的本地资源,则可以使用相对路径:

See my [About](/about/) page for details.

在 Markdown 中指定 HTML 属性

如需向 Markdown 链接添加一个或多个属性,您可以使用以下以空格分隔的格式:

[link text](url){: attribute="value" attribute2="value2" attribute3="value3"} 

您可以在语法中添加 {: .external},提醒读者链接会指向外部网站。

参考式链接使用第二组方括号,并在方括号内添加您选择的用于标识链接的标签:

This is [an example][id] reference-style link.

您可以选择使用空格来分隔两对括号:

This is [an example] [id] reference-style link.

然后,您可以在文档中的任意位置定义链接标签,如下所示,每个标签单独占一行:

(可选)链接网址可能会用尖括号括起来:

您可以将 title [商品名] 属性放在下一行,并用额外的空格或制表符进行内边距。如果网址较长,效果会更好:

链接定义名称可以由字母、数字、空格和标点符号组成,但不区分大小写。例如:访问这两个链接:

[link text][a]
[link text][A]

是等效的。

借助隐式链接名称快捷方式,您可以忽略链接的名称,在这种情况下,链接文本本身将用作名称。只需使用一对方括号,例如将“Google”一词链接起来即可。访问 google.com 网站,只需编写:

[Google]

然后定义链接:

由于链接名称可能包含空格,因此,此快捷键甚至适用于链接文字中的多个字词:

Visit [Daring Fireball] for more information.

然后定义链接:

链接定义可以放在 Markdown 文档中的任意位置。我倾向于将它们紧挨着用于每个段落的后面,但如果您愿意,也可以将它们都放在文档的末尾,就像脚注一样。

以下是一个实际的参考链接示例:

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

对于隐式链接名称快捷方式,您可以这样编写:

I get 10 times more traffic from [Google] than from
[Yahoo] or [MSN].




以上两个示例都将生成以下 HTML 输出:

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

为了进行比较,下面列出了使用 Markdown 内嵌链接样式编写的同一段落:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

Markdown 支持创建“自动”的网址和电子邮件地址的链接:只需用尖括号括住网址或电子邮件地址即可。这意味着,如果您想要显示网址或电子邮件地址的实际文本,并且要将其设置为可点击的链接,则可以进行此操作:

<http://example.com/>

Markdown 会将其转换为:

<a href="http://example.com/">http://example.com/</a>

电子邮件地址自动链接的工作原理与之类似,不同之处在于 Markdown 还会执行一些随机十进制和十六进制实体编码,帮助隐藏您的地址,让垃圾信息机器人收集您的地址。例如,Markdown 会将以下内容:

<address@example.com>

转换为如下形式:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

该网址将在浏览器中显示为“address@example.com”的可点击链接。