内嵌链接
要创建内嵌链接,请在链接文本的右方括号后面使用一对圆括号。在圆括号内添加您要指向的链接网址,以及用引号括起来的链接标题(可选)。例如:
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="mailto:addre
ss@example.co
m">address@exa
mple.com</a>
该网址将在浏览器中显示为“address@example.com”的可点击链接。