Markdown: Markdown 链接语法与引用链接
链接是互联网的基石——在 Markdown 中，一个简单的语法就能把你的文档和整个世界连接起来。
1. 你将学到
- 行内链接和引用链接的语法
- 相对链接在 GitHub 项目中的使用
- 自动链接和邮箱链接
- 用锚点链接跳转到文档内部
- 链接的最佳实践与 SEO 优化
2. 一个文档工程师的真实故事
(1) 痛点：失效的链接让用户迷失
Emma 是一家 SaaS 公司的文档工程师。她发现帮助文档中大约 15% 的链接已经失效——有的因为文件名改了，有的因为外部网站迁移了。用户报告说"点了链接跳到 404 页面"。更麻烦的是，有些链接散落在几十个 Markdown 文件中，改起来耗时数天。
(2) 解法：使用相对链接和引用链接
Emma 制定了链接规范：站内链接全部使用相对路径（不依赖域名），常用链接定义在文档末尾的引用区（一处修改全局生效）。她还写了一个脚本定期扫描检查所有链接的有效性。三个月后，文档链接受损率从 15% 降到了 0.5%。
3. 行内链接
行内链接是 Markdown 中最常用的链接形式，语法直观：
MARKDOWN
[显示文字](链接地址)
[访问 GitHub](https://github.com)
| 部分 | 说明 | 示例 |
|---|---|---|
[显示文字] |
用户看到的可点击文字 | [访问官网] |
(链接地址) |
目标 URL | (https://example.com) |
(1) 添加标题属性
链接后可以加一个可选的 title 属性（鼠标悬停时显示）：
MARKDOWN
[Google](https://google.com "访问 Google 搜索")
[MDN 文档](https://developer.mozilla.org "Web 技术文档大全")
💡 提示： title 属性对 SEO 有轻微帮助，但更重要的是提升可访问性——屏幕阅读器会读出 title 内容。
▶ 示例：不同类型的外部链接
MARKDOWN
- [Google](https://google.com) — 搜索引擎
- [GitHub](https://github.com "全球最大的代码托管平台") — 代码托管
- [MDN Web Docs](https://developer.mozilla.org) — Web 技术文档
(1) 引用链接的三种定义方式
MARKDOWN
方式一（最常用，带中括号）：
[google]: https://google.com
方式二（不带中括号的快捷写法）：
Google: https://google.com
方式三（隐式链接 ID，自动匹配）：
[Google][]
...
[Google]: https://google.com
💡 提示： 隐式链接
[Google][] 会自动使用中括号内的文字作为 ID，查找 [Google]: 的定义。这在链接文字和 ID 相同时非常方便。
▶ 示例：引用链接的完整用法
MARKDOWN
## 推荐资源
学习 Web 开发可以访问 [MDN][] 和 [W3Schools][]。
代码托管推荐 [GitHub][]，问答社区推荐 [Stack Overflow][]。
## 参考
- [MDN][] 的 CSS 文档非常全面
- [Stack Overflow][] 上有大量前端问答
[MDN]: https://developer.mozilla.org/zh-CN/
[W3Schools]: https://www.w3schools.com/
[GitHub]: https://github.com
[Stack Overflow]: https://stackoverflow.com/
💡 提示： 引用链接最大的好处是维护性。如果某个外部链接变了，只需要修改文档末尾的一行定义，所有引用处自动更新。
5. 相对链接
在 GitHub 项目或本地文档中，用相对路径链接到同一项目内的其他文件：
TEXT
📖 仅展示
项目文档：
安装指南 → installation.md
API 参考 → api/overview.md
常见问题 → faq.md
上一节 → chapter-1/intro.md
⚠️ 注意： 相对路径是不依赖域名的。在 GitHub 上，指向同一仓库内其他文件的链接应使用相对路径，而不是绝对 URL——这样仓库克隆到本地或 fork 后链接仍然有效。
▶ 示例：GitHub 项目中的链接结构
TEXT
📖 仅展示
Awesome Project
快速开始：参考 docs/installation.md
贡献指南：查看 CONTRIBUTING.md
相关项目：核心库 (packages/core/README.md)
CLI 工具 (packages/cli/README.md)
6. 自动链接与邮箱链接
(1) 自动链接
用 <> 包裹 URL 或邮箱地址，Markdown 会自动生成链接：
MARKDOWN
<https://example.com>
<user@example.com>
(2) 禁用自动链接
某些场景需要显示 URL 但不生成可点击链接，可以用代码块或转义：
MARKDOWN
`` `https://example.com` ``（转义后显示为代码，不可点击）
或：
\*\*https://example.com\*\* 的写法直接显示 URL
▶ 示例：自动链接 vs 普通文本 URL
MARKDOWN
自动链接：<https://www.google.com>
普通文本（不自动生成链接）：https://www.google.com
带文字链接：[点击访问 Google](https://www.google.com)
💡 提示： 大多数解析器能自动识别以
http:// 或 https:// 开头的 URL 并生成链接，即使你不用 <>。但在标准 Markdown 中，用 <> 包裹是明确的做法。
7. 锚点链接（内部跳转）
锚点链接让用户点击后跳转到同一页面的特定位置：
MARKDOWN
## 目录
- [简介](#1-简介)
- [安装](#2-安装)
- [配置](#3-配置)
---
## 1. 简介
...
跳转到 [回到目录](#目录)
⚠️ 注意： GitHub 自动将标题转换为锚点 ID：中文转拼音或 Unicode，英文转小写+连字符。建议查看实际渲染后页面 URL 中的
# 部分确认锚点值。
▶ 示例：带锚点链接的目录
MARKDOWN
# Python 教程
## 目录
- [安装 Python](#1-安装-python)
- [第一个程序](#2-第一个程序)
- [常见问题](#常见问题)
---
## 1. 安装 Python
...
## 2. 第一个程序
...
## ❓ 常见问题
...
8. 完整示例：文档中的链接网络
MARKDOWN
# Web 开发学习路径
## 前端基础
| 技术 | 文档 | 说明 |
|:-----|:-----|:-----|
| HTML | [MDN HTML][mdn-html] | 网页结构 |
| CSS | [MDN CSS][mdn-css] | 网页样式 |
| JS | [MDN JS][mdn-js] | 交互逻辑 |
## 实战项目
参考 [项目模板][repo] 开始你的第一个网站。
## 相关内容
- 查看 [内部笔记](notes/frontend-roadmap)
- 加入 [社区讨论][forum]
- 联系作者：<author@example.com>
[mdn-html]: https://developer.mozilla.org/zh-CN/docs/Web/HTML
[mdn-css]: https://developer.mozilla.org/zh-CN/docs/Web/CSS
[mdn-js]: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript
[repo]: https://github.com/example/web-starter
[forum]: https://community.example.com
预期效果：一个结构化的文档页面，结合了行内链接、引用链接、表格链接和邮箱链接，构成完整的学习资源网络。
❓ 常见问题
Q 行内链接和引用链接如何选择？
A 一个链接只出现一次用行内式；同一链接多次出现或有集中维护需求用引用式。
Q 链接在新标签页打开怎么做？
A 标准 Markdown 不支持
target="_blank"。需要你手动加 HTML：<a href="url" target="_blank">文字</a>。Q 图片可以加链接吗？
A 可以。用
[](链接url) 的嵌套语法，点击图片跳转到链接。Q 链接 title 属性对 SEO 重要吗？
A 影响不大，但 title 属性可提升可访问性。真正的 SEO 关键在于链接文字本身要有描述性，不要写"点击这里"而是写"查看安装指南"。
📖 小节
- 行内链接：
[文字](url)，最常用、最直观 - 引用链接：
[文字][id]+[id]: url，集中管理 - 相对链接：同一项目内用相对路径，迁移友好
- 自动链接：
<url>或<email>自动生成 - 锚点链接：
#标题跳转到页面内指定位置 - 链接文字要保持描述性，提升可访问性和 SEO
📝 作业
-
基础题：用行内链接写一篇包含 3 个外部引用的小文章（如推荐你常用的 3 个在线工具）。
-
进阶题：将上面的作业改为引用链接实现。然后在 GitHub 上创建一个简短项目，用相对链接将 README.md 引导到
docs/下的子页面。 -
挑战题：写一篇"学习资源汇总"文档，综合使用行内链接、引用链接（至少 5 个）、锚点链接实现目录跳转，并在页尾添加
<user@example.com>邮箱自动链接。
