Skip to content

高级链接技巧

Markdown 提供了多种链接形式,除了基本的行内链接和参考链接外,还有一些高级链接技巧可以让你的文档更加专业和易用。

锚点链接

锚点链接可以让你在文档内部快速导航,特别适合长文档。

创建锚点

在标题前添加锚点标记,或者直接使用标题作为锚点:

markdown
# 目录 {#toc}

## 1. 简介

## 2. 安装

## 3. 使用

[跳转到目录](#toc)
[跳转到简介](#1-简介)

跳转到锚点

使用 [链接文本](#锚点名称) 格式跳转到锚点:

markdown
[跳转到目录](#toc)
[跳转到简介](#1-简介)

注意事项

  • 锚点名称通常是小写的,空格会被替换为连字符 -
  • 不同的 Markdown 渲染器可能对锚点的处理略有不同
  • 建议在测试锚点链接时使用实际的渲染效果

自动链接

对于 URL 和电子邮件地址,Markdown 支持自动链接,无需使用 []() 语法:

markdown
https://www.example.com
user@example.com

显示效果: https://www.example.comuser@example.com

相对路径链接

在项目文档中,你可以使用相对路径链接到其他文件:

同级文件

markdown
[README](README.md)

子目录文件

markdown
[指南](docs/guide.md)

父目录文件

markdown
[主页](../index.md)

图片文件

markdown
![ logo](images/logo.png)

邮件链接

使用 mailto: 协议创建邮件链接:

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

显示效果:发送邮件

带主题的邮件链接

可以在邮件链接中添加主题:

markdown
[发送邮件](mailto:user@example.com?subject=关于Markdown教程)

带正文的邮件链接

可以在邮件链接中添加正文:

markdown
[发送邮件](mailto:user@example.com?subject=关于Markdown教程&body=您好,我对Markdown教程有一些问题...)

参考链接

参考链接可以让你在文档中多次引用同一个链接,而不需要重复写完整的 URL:

基本参考链接

markdown
[链接文本][1]
[另一个链接][1]

[1]: https://www.example.com "链接标题"

命名参考链接

可以使用更有意义的名称作为参考标识:

markdown
[GitHub][github]
[Markdown 官方网站][markdown]

[github]: https://github.com
[markdown]: https://daringfireball.net/projects/markdown/ "Markdown 官方网站"

简短参考链接

如果链接文本和参考标识相同,可以使用简短形式:

markdown
[GitHub]

[GitHub]: https://github.com

链接到图片

可以将图片作为链接:

markdown
[![图片描述](https://www.example.com/image.jpg)](https://www.example.com)

链接到代码块

在支持的编辑器中,可以链接到代码块的特定行:

在 GitHub 中

markdown
[查看代码](https://github.com/username/repository/blob/master/file.js#L10-L20)

在 VS Code 中

使用插件如 "Markdown Preview Enhanced" 可以支持代码块行链接。

小结

高级链接技巧可以让你的 Markdown 文档更加专业和易用,特别是在处理长文档、项目文档和技术文档时。通过使用锚点链接、自动链接、相对路径链接等技巧,你可以创建更加导航友好的文档。

在接下来的章节中,我们将介绍图片处理、Markdown 扩展语法等更多 Markdown 中级技巧。