链接语法 #

概述 #

链接是 Markdown 中连接文档和外部资源的重要方式，支持多种链接格式。

基本语法 #

行内链接 #

语法：[链接文本](链接地址)

markdown

[GitHub](https://github.com)

渲染效果：GitHub

带标题的链接 #

语法：[链接文本](链接地址 "标题")

markdown

[GitHub](https://github.com "访问 GitHub")

鼠标悬停时会显示"访问 GitHub"。

引用式链接 #

基本语法 #

将链接地址定义在文档其他位置：

markdown

这是一个 [引用链接][ref]

[ref]: https://github.com

完整示例 #

markdown

我经常访问 [GitHub][github] 和 [Google][google]。

[github]: https://github.com "GitHub 官网"
[google]: https://google.com "Google 搜索"

引用链接的定义位置 #

可以放在文档任意位置，通常放在文档末尾：

markdown

正文内容...

更多内容...

<!-- 链接定义 -->
[link1]: https://example.com
[link2]: https://example.org

链接类型对比 #

类型	语法	优点	缺点
行内链接	`[文本](URL)`	直观、易读	URL 长时影响阅读
引用链接	`[文本][ref]`	文档整洁	需要额外定义

链接格式详解 #

绝对路径 #

markdown

[绝对路径](https://example.com/page)

相对路径 #

markdown

[相对路径](./page.html)
[上级目录](../index.html)
[根目录](/index.html)

锚点链接 #

跳转到同一页面的指定位置：

markdown

[跳转到标题](#标题名称)

## 标题名称

锚点命名规则 #

标题	锚点
`## 安装指南`	`#安装指南`
`## Hello World`	`#hello-world`
`## API 文档 v2.0`	`#api-文档-v20`

特殊链接 #

邮箱链接 #

markdown

[发送邮件](mailto:example@email.com)

点击后会打开邮件客户端。

电话链接 #

markdown

[拨打电话](tel:+8613800138000)

移动端点击可直接拨打。

自动链接 #

URL 和邮箱自动转换为链接：

markdown

<https://github.com>
<example@email.com>

渲染效果：

https://github.com example@email.com

链接最佳实践 #

描述性文本 #

markdown

好的：
查看 [GitHub 官方文档](https://docs.github.com)

不好的：
点击 [这里](https://docs.github.com) 查看

保持简洁 #

markdown

好的：
[GitHub](https://github.com)

不好的：
[点击此处访问 GitHub 官方网站](https://github.com)

使用引用链接管理链接 #

markdown

正文中的链接：
- [GitHub][gh]
- [Google][gg]
- [MDN][mdn]

<!-- 链接定义 -->
[gh]: https://github.com
[gg]: https://google.com
[mdn]: https://developer.mozilla.org

链接与其他元素组合 #

链接与强调 #

markdown

这是一个 **[重要链接](https://example.com)**
这是一个 *[斜体链接](https://example.com)*

链接与代码 #

markdown

使用 `npm install` 安装，详情见 [文档](https://docs.npmjs.com)

链接与列表 #

markdown

## 常用资源

- [GitHub](https://github.com)
- [Stack Overflow](https://stackoverflow.com)
- [MDN](https://developer.mozilla.org)

常见问题 #

问题1：链接不生效 #

markdown

错误：
[链接](https://example.com)    ← 使用了中文括号

正确：
[链接](https://example.com)    ← 使用英文括号

问题2：链接中有空格 #

markdown

错误：
[链接](https://example.com/page with space)

正确：
[链接](https://example.com/page%20with%20space)

问题3：链接中有括号 #

markdown

错误：
[链接](https://example.com/page(1))

正确：
[链接](https://example.com/page\(1\))

HTML 链接 #

需要更多控制时使用 HTML：

新窗口打开 #

markdown

<a href="https://example.com" target="_blank">新窗口打开</a>

添加样式 #

markdown

<a href="https://example.com" style="color: red;">红色链接</a>

添加属性 #

markdown

<a href="https://example.com" title="提示文字" rel="noopener">链接</a>

实际应用 #

导航链接 #

markdown

## 导航

[首页](/) | [关于](/about) | [联系](/contact)

文档链接 #

markdown

## 相关文档

- [快速开始](./quick-start.md)
- [配置说明](./configuration.md)
- [API 文档](./api.md)

资源链接 #

markdown

## 学习资源

- [React 官方文档](https://react.dev)
- [Vue 官方文档](https://vuejs.org)
- [TypeScript 手册](https://www.typescriptlang.org/docs/)

下一步 #

继续学习图片语法！