Markdown 链接
要创建链接,请将链接文本放在方括号中(例如[Duck Duck Go]),然后立即在其后加上括号中的URL(例如(https://duckduckgo.com))。)./)
Markdown 原文:
My favorite search engine is [Duck Duck Go](https://duckduckgo.com).
渲染效果如下:
My favorite search engine is Duck Duck Go.
添加标题
您可以选择为链接添加标题。当用户将鼠标悬停在链接上时,这将显示为工具提示。要添加标题,请将其括在URL后面的括号中。
Markdown 原文:
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 原文:
<https://www.markdownguide.org>
<fake@example.com>
渲染效果如下:
格式化链接
要强调链接,请在方括号和括号之前和之后添加星号。要将链接表示为代码,请在方括号中添加反引号。
Markdown 原文:
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).
渲染后效果:
I love supporting the EFF.
This is the Markdown Guide.
See the section on code
.
参考样式链接
引用样式链接是一种特殊的链接,它使URL易于在Markdown中显示和阅读。引用样式的链接分为两部分:与文本保持内联的部分以及在文件中其他位置存储的部分,以使文本易于阅读。
格式化链接的第一部分
参考样式链接的第一部分的格式为两组括号。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。
尽管不是必需的,但您可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。
这意味着以下示例格式对于链接的第一部分大致相同:
Markdown 原文:
[hobbit-hole][1]
[hobbit-hole] [1]
格式化链接的第二部分
引用样式链接的第二部分使用以下属性设置格式:
- 标签放在方括号中,紧随其后是冒号和至少一个空格(例如[label]:)。
- 链接的URL,您可以选择将其括在尖括号中。
- 链接的可选标题,您可以将其括在双引号,单引号或括号中。
这意味着以下示例格式对于链接的第二部分几乎都是等效的:
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle “Hobbit lifestyles”
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle ‘Hobbit lifestyles’
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle (Hobbit lifestyles)
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle “Hobbit lifestyles”
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle ‘Hobbit lifestyles’
- [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle (Hobbit lifestyles)
您可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,而其他人则将它们放在文档的末尾(例如尾注或脚注)。
格式化链接示例
Markdown 原文:
这个链接用 1 作为网址变量 Google
然后在文档的结尾为变量赋值(网址)
参考引用:
渲染后的效果
这个链接用 1 作为网址变量 Google
然后在文档的结尾为变量赋值(网址)
参考引用:
- [1]: http://www.google.com/
- [cncfstack]: http://www.zhaowenyu.com/
最佳实践
- 链接标题使用双引号””定界,也可以使用单引号’’进行定界。
- 可以不需要链接标题,只保留链接地址即可。
- 链接标题应与链接地址之间使用空格隔开。
- 如果链接地址在本域,可以使用相对链接的形式。
- 可以使用尖括号<>对链接地址进行定界。
- 引用方式中,方括号后跟一个冒号:,冒号后跟一个或多个空格。
- 引用方式中,两组方括号之间可以使用空格分开。
- 引用方式中,被引用的内容部分可以放在文档中的任意位置。
- 引用方式中,链接标题的定界符还可以使用圆括号()。
- 引用方式中,标题可以另起一行,可自由缩进。
- 引用方式中,定义的名称不区分大小写。
- 引用方式中,如果链接文本与引用的定义名称一样,后面的方括号内容可以置空。