内联链接
最常用的链接语法：文字在方括号中，URL 在圆括号中：
源码
[古法编程](https://gufacode.com)
[GitHub](https://github.com "GitHub 首页")
# 第三个参数是悬停提示（title）
相对路径链接
# 链接到同目录文件 [安装指南](./install.md) # 链接到上级目录 [返回首页](../README.md) # 链接到页面内锚点 [跳转到安装章节](#安装)
引用链接
当同一链接在文档中多次出现时，引用风格更易维护：
# 在文本中使用引用 [古法编程][gufacode] 是一个编程教程网站。 你可以在 [古法编程][gufacode] 找到更多教程。 # 在文档底部（任意位置）定义引用 [gufacode]: https://gufacode.com "古法编程"
TIP引用链接的定义可以放在文档的任意位置，通常集中放在文档末尾，类似参考文献列表。引用标识符不区分大小写。
自动链接
用尖括号可以让 URL 自动变成可点击的链接：
<https://gufacode.com> <user@example.com>
GFM 还支持自动识别链接（不需要尖括号）：
https://gufacode.com 会自动变成链接
图片
图片语法与链接非常相似，在前面加一个 !：
  
INFO替代文字（alt text）在图片无法加载时显示，也被屏幕阅读器使用。请提供有意义的描述，而不是留空或写 "image"。
图片链接
将链接语法和图片语法嵌套，创建可点击的图片：
[](https://example.com)
控制图片尺寸
原生 Markdown 不支持设置图片尺寸，需要使用 HTML：
<img src="image.png" alt="说明" width="300"> <img src="image.png" alt="说明" width="50%">
徽章（Badge）
GitHub README 常见的彩色小徽章，通过图片链接实现。常用服务：
| 服务 | 用途 | 示例 |
|---|---|---|
| shields.io | 自定义徽章 | 版本、许可证、构建状态 |
| GitHub Actions | CI 状态徽章 | 自动生成于工作流设置 |
| codecov.io | 代码覆盖率 | 显示测试覆盖百分比 |
| img.shields.io | npm/PyPI 版本 | 显示包版本号 |
# shields.io 自定义徽章格式  # 示例：许可证徽章  # GitHub Actions 构建状态 
链接最佳实践
1. 用有意义的链接文字
# ❌ 不好 更多信息请[点击这里](https://example.com) # ✅ 好 查看[完整 API 文档](https://example.com)
2. 检查外部链接有效性
使用工具如 markdown-link-check 或 GitHub Action 定期检查断链：
npm install -g markdown-link-check markdown-link-check README.md
3. 相对路径 vs 绝对路径
- 相对路径：适合文档间的内部链接，随仓库移动不会失效
- 绝对路径：适合外部网站链接
小结
- 内联链接：
[文字](URL)；引用链接适合多次引用同一 URL - 图片：
，加!前缀；控制尺寸需用 HTML<img> - 自动链接：
<URL>或 GFM 直接识别 https:// 链接 - 徽章是可点击图片链接的典型应用，shields.io 是最常用的服务