链接语法

要创建链接，请将链接文本括在方括号（例如 <code>[Duck Duck Go]</code>）中，后面紧跟着括在圆括号中的 URL（例如 `(https://duckduckgo.com)` ）。

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

渲染效果如下：

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

<div class="callout callout-info"><strong>Note:</strong> To link to an element on the same page, see <a href="/extended-syntax/#linking-to-heading-ids">linking to heading IDs</a>. To create a link that opens in a new tab or window, see the section on <a href="http://www.bixiaguangnian.com/manual/markdown/4133.html">link targets</a>.</div>

## 添加标题

你可以选择为链接添加标题（即 title 属性）。当用户将鼠标悬停在链接上时，将显示一个提示。要添加标题，请将其放在 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](https://duckduckgo.com "The best search engine for privacy").

## 网址和电子邮件地址

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

```markdown
<https://www.markdownguide.org>
<fake@example.com>
```

渲染效果如下：

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

## 格式化链接

如需强调（emphasize） 某个链接, 请在方括号前及圆括号后添加星号。要将链接表示为代码（code），请在方括号内添加反引号。

```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](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).

## 引用式链接

引用式（Reference-style）链接是一种特殊类型的链接，它使得 URL 在 Markdown 中更易于显示和阅读。引用式链接由两部分组成：一部分被放置在正文文本中；另一部分被放置在文档中的其它地方，以便于阅读。

### 引用式链接第一部分的格式

引用式链接的第一部分的格式由两组方括号组成。第一组方括号内放的是显示为链接的文本，第二组方括号内放的是一个标签，该标签用于指向您存放在文档中其它位置的链接。

尽管不是必须的，但你可以在第一组和第二组方括号之间添加一个空格。第二组方括号中的标签不区分大小写，并且可以包含字母、数字、空格或标点符号。

以下示例中，链接的第一部分是等效的：

- `[hobbit-hole][1]`
- `[hobbit-hole] [1]`

### 引用式链接第二部分的格式

引用式链接的第二部分可以包含以下属性：

1. 放在方括号内的标签，以及紧跟在方括号后面的一个冒号和至少一个空格（例如 `[label]: `）。
2. 链接的 URL，可以选择将其括在尖括号内。
3. 链接的标题（可有可无），可以将其括在双引号、单引号或括号内。

以下示例中，链接的第二部分是等效的：

- `[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]: &lt;https://en.wikipedia.org/wiki/Hobbit#Lifestyle&gt; "Hobbit lifestyles"`
- `[1]: &lt;https://en.wikipedia.org/wiki/Hobbit#Lifestyle&gt; 'Hobbit lifestyles'`
- `[1]: &lt;https://en.wikipedia.org/wiki/Hobbit#Lifestyle&gt; (Hobbit lifestyles)`

可以将链接的第二部分放在 Markdown 文档中的任何位置。有些人将它们放在被引用的段落的后面，有些人将它们放在文档的末尾（类似尾注或脚注）。

### 将两部分组合在一起使用的示例

假设你将一个 URL 作为一个标准 URL 链接 添加到段落中，在 Markdown 中如下所示：

```markdown
In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends
of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to
eat: it was a [hobbit-hole](https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"), and that means comfort.
```

Though it may point to interesting additional information, the URL as displayed really doesn’t add much to the existing raw text other than making it harder to read. To fix that, you could format the URL like this instead:

[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> "Hobbit lifestyles"

```

在上述两个实例中，渲染后的输出是相同的：

In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends
of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to
eat: it was a [hobbit-hole](https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"), and that means comfort.

该链接的 HTML 为：

```markdown
<a href="https://en.wikipedia.org/wiki/Hobbit#Lifestyle" title="Hobbit lifestyles">hobbit-hole</a>
```

## 链接（Link）的最佳使用实践

不同的 Markdown 应用程序在处理 URL 中间的空格方面是不一样的。为了兼容起见，请尽量使用 <code>%20</code> （空格的编码形式）来代替空格。或者，如果你的 Markdown 应用程序支持 HTML 的话，你可以使用 HTML 的 <code>a</code> 标签。

<table><thead><tr><th>✅&nbsp;这样做</th><th>❌&nbsp;不要这样做</th></tr></thead><tbody><tr><td>`[link](https://www.example.com/my%20great%20page)`<br /><br/>`<a href="https://www.example.com/my great page">link</a>`</td><td>`[link](https://www.example.com/my great page)`</td></tr></tbody></table>

Parentheses in the middle of a URL can also be problematic. For compatibility, try to URL encode the opening parenthesis (<code>(</code>) with <code>%28</code> and the closing parenthesis (<code>)</code>) with <code>%29</code>. Alternatively, if your Markdown application supports HTML, you could use the <code>a</code> HTML tag.

<table><thead><tr><th>✅&nbsp;Do this</th><th>❌&nbsp;Don't do this</th></tr></thead><tbody><tr><td>`[a novel](https://en.wikipedia.org/wiki/The_Milagro_Beanfield_War_%28novel%29)`<br /><br/>`<a href="https://en.wikipedia.org/wiki/The_Milagro_Beanfield_War_(novel)">a novel</a>`</td><td>`[a novel](https://en.wikipedia.org/wiki/The_Milagro_Beanfield_War_(novel))`</td></tr></tbody></table>