Markdown 链接(八)

8.链接

涵盖基本语法、参考链接、自动识别及锚点用法。

一、基本语法

1. 行内式链接

[链接文字](URL "可选标题")

示例

这是一个链接 [菜鸟教程](https://www.runoob.com)
欢迎访问 [GitHub](https://github.com) 官网
[百度搜索](https://www.baidu.com "百度一下,你就知道")
  • 可选标题:鼠标悬停时显示提示,放在双引号、单引号或括号中都可以
  • 中括号与圆括号之间无空格

2. 直接使用 URL

<https://www.runoob.com>

或自动识别(部分解析器支持):

https://www.runoob.com

3. 邮箱 / 电话链接

[发送邮件](mailto:example@email.com)
[拨打电话](tel:+86-138-0013-8000)

二、参考式链接(推荐用于长文档)

将链接定义与使用分离,提高可读性。

语法结构

[链接文字][参考标签]

[参考标签]: URL "可选标题"

示例

这个链接用 1 作为变量 [Google][1]
这个链接用 runoob 作为变量 [Runoob][runoob]

[1]: http://www.google.com/
[runoob]: http://www.runoob.com/

简化写法(链接文字与标签相同):

我喜欢使用 [GitHub][] 来管理代码。

[GitHub]: https://github.com

优势

  • 正文清爽,不被长 URL 打断
  • 便于统一管理和更新
  • 同一链接可重复使用
  • 链接定义可放在文档末尾

组织技巧示例

## 在线教程
- [MDN Web Docs][mdn]
- [RUNOOB][rnb]

<!-- 链接定义区域 -->
[mdn]: https://developer.mozilla.org/
[rnb]: https://www.runoob.com/

三、自动识别链接

现代解析器通常支持自动识别 URL 和邮箱地址。

类型 语法
裸 URL https://example.com
尖括号包围 <https://example.com>
邮箱 example@email.com​ 或 <example@email.com>

⚠️ 为确保兼容性,建议始终使用标准的链接语法。

四、锚点链接(页面内跳转)

用于长文档导航,跳转到指定标题或自定义位置。

4.1 跳转到标题

标题会自动生成锚点,规则:

  • 小写
  • 空格替换为 -
  • 移除特殊字符

示例

## 目录
- [第一章:介绍](#第一章介绍)
- [第二章:安装](#第二章安装)

# 第一章:介绍
这里是内容...

4.2 手动创建锚点

<a id="custom-anchor"></a>
## 自定义锚点位置

[跳转到自定义位置](#custom-anchor)

4.3 返回顶部

[回到顶部](#)

总结速查表

链接类型 语法 适用场景
行内式 [文字](URL "标题") 简单链接,出现一次
参考式 [文字][标签]​ + [标签]: URL 长文档,链接重复使用
直接 URL <URL>​ 或 URL 直接展示网址
邮箱/电话 mailto:​ / tel: 联系方式
锚点 #标题锚点 页面内导航

关键规则

  • 中括号与圆括号之间无空格
  • 标题可选,用双引号包围
  • 参考式链接定义通常放在文档末尾