Markdown 链接
🔗 基础链接语法
标准格式
[显示文字](目标地址 "可选提示文本")- 必填项：
[显示文字]+(目标地址) - 可选项：
"提示文本"（鼠标悬停时显示，增强可访问性与用户体验）
实用协议示例
📧 邮件联系：[发送邮件](mailto:contact@example.com "点击发送咨询邮件") 📞 电话联系：[拨打电话](tel:+8613800138000 "工作日 9:00-18:00") 🌐 官网链接：[访问官网](https://example.com "企业官方网站") 📁 本地文档：[查看手册](./docs/guide.md "项目使用手册")💡提示：
tel:链接建议移除连字符（+8613800138000），部分设备对格式敏感- 链接含空格/特殊字符时，建议对 URL 进行编码（如
%20代替空格）- 提示文本中的双引号需转义：
"查看\"示例\""→ 显示为查看"示例"
📌 锚点链接（文档内跳转）
自动生成锚点（基于标题）
## 目录 - [第一章：介绍](#第一章介绍) - [第二章：安装](#第二章安装) - [第三章：使用方法](#第三章使用方法) # 第一章：介绍 内容开始...🔑 锚点生成规则（主流平台通用）
| 原始标题 | 生成锚点（小写） | 说明 |
|---|---|---|
第一章：介绍 | #第一章介绍 | 中文保留（GitHub 支持） |
Install Guide | #install-guide | 空格→连字符，移除标点 |
API (v2) | #api-v2 | 括号/冒号等特殊字符移除 |
重复标题 | #重复标题-1 | 自动添加序号防冲突 |
⚠️平台差异提醒
- GitHub/GitLab：完美支持中文锚点（URL 会编码，但链接写法保留中文）
- 部分旧解析器：中文锚点可能失效 → 建议关键位置使用手动锚点
- 测试技巧：在预览模式点击标题，观察浏览器地址栏变化确认锚点
手动创建锚点（精准控制）
<aid="custom-section"></a><!-- 推荐：现代标准 --><!-- 或 --><aname="legacy-anchor"></a><!-- 兼容旧系统 -->[跳转到自定义位置](#custom-section)✅最佳实践
id命名规范：小写字母+连字符（如#api-reference）- 确保页面内
id唯一，避免跳转错乱 - 将
<a>标签置于目标内容上方空行处，提升跳转定位准确性
便捷导航技巧
[▴ 回到顶部](#top) <!-- 需在文档开头设置 <a id="top"></a> --> [⌂ 返回目录](#目录) <!-- 建议目录标题设为“目录”并添加锚点 -->🌟专业提示：在长文档开头添加
<a id="top"></a>，全文明统一使用[▴ 顶部](#top)
💡 高阶技巧与避坑指南
| 场景 | 推荐方案 | 原因说明 |
|---|---|---|
| 文档内章节跳转 | 自动生成锚点 + 目录导航 | 结构清晰，维护成本低 |
| 精确定位非标题区域 | 手动<a id="..."> | 避免解析器规则差异 |
| 多语言文档 | 英文锚点 + 中文显示文字 | 兼容所有平台（如#install） |
| 链接含反引号 | 用空格分隔：[text](url) | 防止语法解析冲突 |