Markdown链接
跳到导航
跳到搜索
Markdown支持两种样式的链接:内联链接和引用链接。
在这两种样式中,链接文本由方括号包围。
要创建内联链接,在链接文本的右方括号后面使用一对普通括号。括号内放置链接指向的URL,以及可选的链接标题,用引号括起来。例如:
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.
引用链接使用第二组方括号,你可以在其中放置一个你选择的标签来标识链接:
This is [an example][id] reference-style link.
你可以选择使用一个空格来分隔这两组方括号:
This is [an example] [id] reference-style link.
然后,在文档的任何地方,你可以像这样定义你的链接标签,每行一个:
[id]: http://example.com/ "Optional Title Here"
也就是:
- 方括号包含链接标识符(可选择通过最多三个空格向右缩进);
- 后面跟着一个冒号;
- 后面跟着一个或多个空格(或制表符);
- 后面跟着链接的URL;
- 可选地后面跟着链接的标题属性,用双引号、单引号或括号括起来。
以下三个链接定义是等效的:
[foo]: http://example.com/ "可选标题在这里" [foo]: http://example.com/ '可选标题在这里' [foo]: http://example.com/ (可选标题在这里)
链接URL可以选择使用尖括号括起来:
[id]: <http://example.com/> "可选标题在这里"
您可以将标题属性放在下一行,并使用额外的空格或制表符进行填充,这在较长的URL中看起来更好:
[id]: http://example.com/longish/path/to/resource/here "可选标题在这里"
链接定义仅在Markdown处理期间用于创建链接,并在HTML输出中从您的文档中删除。
链接定义名称可以由字母、数字、空格和标点符号组成,但它们不区分大小写。例如,下面的两个链接:
[链接文本][a] [链接文本][A]
是等效的。