Markdown链接

来自泡泡学习笔记
BrainBs讨论 | 贡献2023年7月23日 (日) 16:43的版本
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航 跳到搜索

Markdown支持两种样式的链接:内联链接和引用链接。


在这两种样式中,链接文本由方括号包围。


要创建内联链接,在链接文本的右方括号后面使用一对普通括号。括号内放置链接指向的URL,以及可选的链接标题,用引号括起来。例如:

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

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

Markdown链接-1.png


将会生成:

<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链接-2.png


引用链接使用第二组方括号,你可以在其中放置一个你选择的标签来标识链接:

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

Markdown链接-3.png


你可以选择使用一个空格来分隔这两组方括号:

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]

是等效的。