Markdown 链接
链接是使 Markdown 文档具有交互性的关键元素。
掌握链接语法能让你创建内容丰富、易于导航的文档。
链接使用方法如下:
[链接名称](链接地址)
[链接文字](链接地址 "可选的标题")
或者:
<链接地址>
一个简单的链接:
这是一个链接 [菜鸟教程](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
用尖括号包围:
邮箱自动识别:
markdown联系邮箱:example@email.com
或者:
注意事项:
自动识别功能依赖于具体的 Markdown 解析器
为了确保兼容性,建议使用标准的链接语法
某些特殊字符可能影响自动识别
锚点链接的使用
锚点链接用于在同一文档内跳转,特别适合长文档的导航:
跳转到标题:
## 目录
- [第一章:介绍](#第一章介绍)
- [第二章:安装](#第二章安装)
- [第三章:使用方法](#第三章使用方法)
# 第一章:介绍
这里是介绍内容...
# 第二章:安装
这里是安装说明...
# 第三章:使用方法
这里是使用说明...
锚点规则:
标题会自动生成锚点
锚点名称通常是标题的小写形式
空格替换为连字符
移除特殊字符
手动创建锚点:
## 自定义锚点位置
[跳转到自定义位置](#custom-anchor)
页面顶部返回链接:
[回到顶部](#)