MDUtil

Markdown 链接

把链接文字写在方括号里,网址写在圆括号里:[文字](https://example.com)。本文介绍各种链接写法、跳转到标题和其他文件的链接,以及聊天软件里的情况。

简短回答

Markdown 怎么加超链接?

方括号里写链接文字,紧接着在圆括号里写网址,中间不能有空格:[示例](https://example.com)。网址后面加引号里的标题,鼠标悬停时会显示;把网址放进尖括号 <https://example.com>,网址本身就会变成链接。

Markdown
[示例网站](https://example.com)

<https://example.com>

链接的写法和示例

下面的写法都会生成普通的 <a> 链接,区别在于网址的写法。

带标题的链接

网址后面引号里的文字是链接标题,浏览器会在鼠标悬停时显示。

Markdown
[示例网站](https://example.com "悬停时显示")

显示效果

自动链接

尖括号里的网址会链接到它自己。GitHub 风格 Markdown 还会把单独的 https://、www. 网址和尖括号里的邮箱地址变成链接。

Markdown
<https://example.com>

https://example.com

<[email protected]>

引用式链接

给网址起一个标签,在文档任意位置定义。长网址不会打断段落,多个链接也可以共用一个网址。

Markdown
请阅读[写作规范][style]和[常见问题][faq]。

[style]: https://example.com/style
[faq]: https://example.com/faq

显示效果

跳转到标题

用 # 加标题的 id。大多数渲染器把标题文字转成小写、空格换成连字符作为 id,中文标题会保留中文。

Markdown
[跳到安装步骤](#安装步骤)

显示效果

网址里有空格或括号

含空格的网址用尖括号包住。成对的圆括号可以直接保留。

Markdown
[年度报告](<https://example.com/annual report.pdf>)

[消歧义页](https://en.wikipedia.org/wiki/Markdown_(disambiguation))

带链接的图片

把图片写在链接文字的位置,图片就可以点击,README 里的徽章就是这样写的。

Markdown
[![文档状态](/samples/badge.svg)](https://example.com/docs)

显示效果

文档状态

各平台的链接支持

[文字](网址) 几乎处处可用,聊天软件是例外。

应用支持情况说明
GitHub / GitLab支持所有链接写法都支持,单独的网址会变成链接,标题会生成可跳转的 id。
Discord有差异消息里可以用 [文字](https://…),单独的网址也会变成链接。
Slack有差异在偏好设置的高级选项里开启“Format messages with markup”后可以用 [文字](网址),否则要用链接按钮添加。
Obsidian支持支持 Markdown 链接,[[笔记名]] 可以链接到其他笔记。
Typora支持所有链接写法都支持,按住 Ctrl 或 ⌘ 点击打开。

常见问题

为什么 Markdown 链接没有生效?

检查 ] 和 ( 之间是否有空格,网址里是否有空格(用 < > 包住),以及是否漏了 https://,漏掉时网址会被当成当前网站上的路径。

怎样链接到同一页的某个标题?

用 # 加标题的 id:[安装](#安装)。GitHub 会把标题文字转成小写、空格换成连字符、去掉大部分标点作为 id。

Discord 里怎么加超链接?

在消息里写 [文字](https://example.com),Discord 会把文字显示成链接。

Markdown 链接能在新标签页打开吗?

Markdown 没有这样的语法。允许 HTML 的地方可以写成 HTML:<a href="https://example.com" target="_blank">文字</a>,会清理 HTML 的网站可能去掉 target。

行内链接和引用式链接有什么区别?

行内链接把网址紧跟在文字后面;引用式链接用简短的标签,把网址集中写在别处,段落里不会出现长网址,多个链接还能共用一个网址。

怎样链接到另一个 Markdown 文件?

用相对路径:[指南](docs/guide.md)。GitHub 和大多数网站生成器会打开那个文件对应的页面。

怎样写邮箱链接?

把邮箱地址放进尖括号:<[email protected]>,或者写成 [联系我们](mailto:[email protected])。

怎样显示方括号而不变成链接?

在左方括号前加反斜杠:\[不是链接](https://example.com)。