Markdown 链接

要创建链接,请将链接文本放在方括号中(例如[Duck Duck Go]),然后立即在其后加上括号中的URL(例如(https://duckduckgo.com))。)./)

Markdown 原文:

  1. My favorite search engine is [Duck Duck Go](https://duckduckgo.com).

渲染效果如下:

My favorite search engine is Duck Duck Go.

添加标题

您可以选择为链接添加标题。当用户将鼠标悬停在链接上时,这将显示为工具提示。要添加标题,请将其括在URL后面的括号中。

Markdown 原文:

  1. My favorite search engine is [Duck Duck Go](https://duckduckgo.com "The best search engine for privacy").

渲染效果如下:

My favorite search engine is Duck Duck Go.

自动链接(Urls 和 邮件地址链接)

要将 URL 或电子邮件地址快速转换为链接,请将其括在尖括号中。

Markdown 原文:

  1. <https://www.markdownguide.org>
  2. <fake@example.com>

渲染效果如下:

https://www.markdownguide.org

fake@example.com

格式化链接

要强调链接,请在方括号和括号之前和之后添加星号。要将链接表示为代码,请在方括号中添加反引号。

Markdown 原文:

  1. I love supporting the **[EFF](https://eff.org)**.
  2. This is the *[Markdown Guide](https://www.markdownguide.org)*.
  3. See the section on [`code`](#code).

渲染后效果:

I love supporting the EFF.

This is the Markdown Guide.

See the section on code.

参考样式链接

引用样式链接是一种特殊的链接,它使URL易于在Markdown中显示和阅读。引用样式的链接分为两部分:与文本保持内联的部分以及在文件中其他位置存储的部分,以使文本易于阅读。

格式化链接的第一部分

参考样式链接的第一部分的格式为两组括号。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。

尽管不是必需的,但您可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。

这意味着以下示例格式对于链接的第一部分大致相同:

Markdown 原文:

  1. [hobbit-hole][1]
  2. [hobbit-hole] [1]

格式化链接的第二部分

引用样式链接的第二部分使用以下属性设置格式:

  • 标签放在方括号中,紧随其后是冒号和至少一个空格(例如[label]:)。
  • 链接的URL,您可以选择将其括在尖括号中。
  • 链接的可选标题,您可以将其括在双引号,单引号或括号中。

这意味着以下示例格式对于链接的第二部分几乎都是等效的:

您可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,而其他人则将它们放在文档的末尾(例如尾注或脚注)。

格式化链接示例

Markdown 原文:

这个链接用 1 作为网址变量 Google

然后在文档的结尾为变量赋值(网址)

参考引用:

渲染后的效果

这个链接用 1 作为网址变量 Google

然后在文档的结尾为变量赋值(网址)

参考引用:

最佳实践

  • 链接标题使用双引号””定界,也可以使用单引号’’进行定界。
  • 可以不需要链接标题,只保留链接地址即可。
  • 链接标题应与链接地址之间使用空格隔开。
  • 如果链接地址在本域,可以使用相对链接的形式。
  • 可以使用尖括号<>对链接地址进行定界。
  • 引用方式中,方括号后跟一个冒号:,冒号后跟一个或多个空格。
  • 引用方式中,两组方括号之间可以使用空格分开。
  • 引用方式中,被引用的内容部分可以放在文档中的任意位置。
  • 引用方式中,链接标题的定界符还可以使用圆括号()。
  • 引用方式中,标题可以另起一行,可自由缩进。
  • 引用方式中,定义的名称不区分大小写。
  • 引用方式中,如果链接文本与引用的定义名称一样,后面的方括号内容可以置空。