现在位置: 首页 > Markdown 教程 > 正文

Markdown 链接

链接是使 Markdown 文档具有交互性的关键元素。

掌握链接语法能让你创建内容丰富、易于导航的文档。

链接使用方法如下:

[链接名称](链接地址)
[链接文字](链接地址 "可选的标题")

或者:

<链接地址>

一个简单的链接:

这是一个链接 [菜鸟教程](https://www.runoob.com)

显示结果如下:

直接使用链接地址:

<https://www.runoob.com>

显示结果如下:

设置可选标题:

这是一个链接 [菜鸟教程](https://www.runoob.com)
欢迎访问 [GitHub](https://github.com) 官网
这是 [百度搜索](https://www.baidu.com "百度一下,你就知道")

显示结果如下:

链接标题的作用:

  • 当鼠标悬停在链接上时显示提示信息
  • 对搜索引擎优化和无障碍访问有帮助
  • 标题文字放在双引号、单引号或括号中都可以

邮箱链接:

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

参考链接

参考式链接将链接定义与使用分离,让文档更整洁,特别适合长文档或需要多次引用相同链接的情况。

基本语法:

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

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

我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:

这个链接用 1 作为网址变量 [Google][1]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)

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

显示结果如下:

简化写法:

当参考标签与链接文字相同时,可以省略第二个方括号:

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

[GitHub]: https://github.com

参考链接的优势:

  • 文档正文更清爽,不被长 URL 打断
  • 便于链接的统一管理和更新
  • 相同链接可以重复使用,避免重复定义
  • 链接定义可以放在文档任意位置(通常放在末尾)

组织技巧:

markdown# 学习资源推荐

## 在线教程
- [MDN Web Docs][mdn] - 权威的 Web 技术文档
- [RUNOOB][rnb] - 适合初学者的教程网站
- [freeCodeCamp][fcc] - 免费的编程学习平台

## 代码托管
- [GitHub][github] - 最受欢迎的代码托管服务
- [GitLab][gitlab] - 企业级的代码管理平台

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

自动链接识别

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

URL 自动识别:

markdown直接输入网址:https://www.example.com
用尖括号包围:<https://www.example.com>

邮箱自动识别:

markdown联系邮箱:example@email.com
或者:<example@email.com>

注意事项:

  • 自动识别功能依赖于具体的 Markdown 解析器
  • 为了确保兼容性,建议使用标准的链接语法
  • 某些特殊字符可能影响自动识别

锚点链接的使用

锚点链接用于在同一文档内跳转,特别适合长文档的导航:

跳转到标题:

## 目录
- [第一章:介绍](#第一章介绍)
- [第二章:安装](#第二章安装)
- [第三章:使用方法](#第三章使用方法)

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

# 第二章:安装
这里是安装说明...

# 第三章:使用方法
这里是使用说明...

锚点规则:

  • 标题会自动生成锚点
  • 锚点名称通常是标题的小写形式
  • 空格替换为连字符
  • 移除特殊字符

手动创建锚点:

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

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

页面顶部返回链接:

[回到顶部](#)