Markdown 链接
链接是使 Markdown 文档具有交互性的关键元素。
掌握链接语法能让你创建内容丰富、易于导航的文档。
链接使用
markdown
[链接名称](链接地址)
[链接文字](链接地址 "可选的标题")或者
markdown
<链接地址>显示结果:
<链接地址>
简单的链接
markdown
这是一个链接 [菜鸟教程](https://www.runoob.com)显示结果:
这是一个链接 菜鸟教程
直接使用链接地址:
markdown
<https://www.runoob.com>设置可选标题:
markdown
这是一个链接 [菜鸟教程](https://www.runoob.com)
欢迎访问 [GitHub](https://github.com) 官网
这是 [百度搜索](https://www.baidu.com "百度一下,你就知道")链接标题的作用:
- 当鼠标悬停在链接上时显示提示信息
- 对搜索引擎优化和无障碍访问有帮助
- 标题文字放在双引号、单引号或括号中都可以
邮箱链接:
markdown
markdown联系我:[发送邮件](mailto:example@email.com)
电话联系:[拨打电话](tel:+86-138-0013-8000)参考链接
参考式链接将链接定义与使用分离,让文档更整洁,特别适合长文档或需要多次引用相同链接的情况。
基本语法:
markdown
markdown[链接文字][参考标签]
[参考标签]: URL "可选标题"显示结果:
markdown链接文字
我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:
markdown
这个链接用 1 作为网址变量 [Google][1]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/
[runoob]: http://www.runoob.com/简化写法:
当参考标签与链接文字相同时,可以省略第二个方括号:
markdown
markdown 我喜欢使用 [GitHub][] 来管理代码。
[GitHub]: https://github.com显示结果:
markdown 我喜欢使用 GitHub 来管理代码。
参考链接的优势:
- 文档正文更清爽,不被长 URL 打断
- 便于链接的统一管理和更新
- 相同链接可以重复使用,避免重复定义
- 链接定义可以放在文档任意位置(通常放在末尾)
组织技巧:
markdown
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# 学习资源推荐
在线教程
- MDN Web Docs - 权威的 Web 技术文档
- RUNOOB - 适合初学者的教程网站
- freeCodeCamp - 免费的编程学习平台
代码托管
自动链接识别
现代 Markdown 解析器通常支持自动识别 URL 和邮箱地址:
URL 自动识别:
markdown
markdown直接输入网址:https://www.example.com
用尖括号包围:<https://www.example.com>显示结果:
markdown直接输入网址:https://www.example.com 用尖括号包围:https://www.example.com
邮箱自动识别:
markdown
markdown联系邮箱:example@email.com
或者:<example@email.com>显示结果:
markdown联系邮箱:example@email.com 或者:example@email.com
注意事项:
- 自动识别功能依赖于具体的 Markdown 解析器
- 为了确保兼容性,建议使用标准的链接语法
- 某些特殊字符可能影响自动识别
锚点链接的使用
锚点链接用于在同一文档内跳转,特别适合长文档的导航:
跳转到标题:
markdown
## 目录
- [第一章:介绍](#第一章介绍)
- [第二章:安装](#第二章安装)
- [第三章:使用方法](#第三章使用方法)
# 第一章:介绍
这里是介绍内容...
# 第二章:安装
这里是安装说明...
# 第三章:使用方法
这里是使用说明...锚点规则:
- 标题会自动生成锚点
- 锚点名称通常是标题的小写形式
- 空格替换为连字符
- 移除特殊字符
手动创建锚点:
markdown
<a id="custom-anchor"></a>
## 自定义锚点位置
[跳转到自定义位置](#custom-anchor)页面顶部返回链接:
markdown
[回到顶部](#)显示结果: