鏈接語法
鏈接是 Markdown 中連接內容的重要元素。掌握各種鏈接語法能讓你的文檔更具連通性和實用性。
基本鏈接語法
內聯鏈接
使用 [鏈接文本](URL)
的格式創建鏈接:
markdown
這是一個指向 [Google](https://www.google.com) 的鏈接。
訪問 [GitHub](https://github.com) 查看開源項目。
渲染效果:
這是一個指向 Google 的鏈接。 訪問 GitHub 查看開源項目。
帶標題的鏈接
在 URL 後添加標題,鼠標懸停時會顯示:
markdown
這是一個 [帶標題的鏈接](https://www.example.com "這是鏈接標題")。
渲染效果:
這是一個 帶標題的鏈接。
引用式鏈接
基本引用式鏈接
將鏈接定義與使用分離:
markdown
這是一個 [引用式鏈接][1]。
這是另一個 [引用式鏈接][link-name]。
[1]: https://www.example.com
[link-name]: https://www.google.com "Google搜索"
渲染效果:
隱式鏈接標簽
鏈接文本本身作為標簽:
markdown
訪問 [Google][] 進行搜索。
查看 [GitHub][] 上的項目。
[Google]: https://www.google.com
[GitHub]: https://github.com
渲染效果:
訪問 Google 進行搜索。 查看 GitHub 上的項目。
自動鏈接
URL 自動鏈接
直接輸入 URL,用尖括號包圍:
markdown
<https://www.example.com>
<https://github.com/user/repo>
渲染效果:
https://www.example.comhttps://github.com/user/repo
郵箱自動鏈接
markdown
聯系我:<user@example.com>
技術支持:<support@company.com>
渲染效果:
聯系我:user@example.com 技術支持:support@company.com
內部鏈接
錨點鏈接
鏈接到同一頁面的標題:
markdown
跳轉到 [基本鏈接語法](#基本鏈接語法)
查看 [最佳實踐](#最佳實踐)
渲染效果:
相對路徑鏈接
鏈接到其他文件:
markdown
查看 [標題語法](headings.md)
返回 [首頁](../index.md)
特殊鏈接
圖片鏈接
將圖片包裝在鏈接中:
markdown
[](https://www.example.com)
下載鏈接
鏈接到文件下載:
markdown
下載 [用戶手冊](files/manual.pdf)
獲取 [示例代碼](examples/demo.zip)
鏈接文本格式化
帶格式的鏈接文本
markdown
這是一個 [**粗體鏈接**](https://www.example.com)
這是一個 [*斜體鏈接*](https://www.example.com)
這是一個 [`代碼樣式鏈接`](https://www.example.com)
渲染效果:
這是一個 粗體鏈接 這是一個 斜體鏈接 這是一個 代碼樣式鏈接
多行鏈接文本
markdown
這是一個 [很長的鏈接文本,
可能需要換行顯示](https://www.example.com)
常見錯誤和解決方案
1. 括號不匹配
markdown
❌ 錯誤:
[鏈接文本(https://www.example.com) ← 缺少右括號
✅ 正確:
[鏈接文本](https://www.example.com)
2. 空格問題
markdown
❌ 錯誤:
[ 鏈接文本 ]( https://www.example.com ) ← 不必要的空格
✅ 正確:
[鏈接文本](https://www.example.com)
3. URL 編碼
對於包含特殊字符的 URL:
markdown
❌ 可能有問題:
[搜索](https://www.google.com/search?q=markdown)
✅ 更安全:
[搜索](https://www.google.com/search?q=markdown)
或使用引用式:
[搜索][google-search]
[google-search]: https://www.google.com/search?q=markdown
最佳實踐
1. 使用描述性鏈接文本
markdown
✅ 推薦:描述性文本
查看 [Markdown 官方語法文檔](https://daringfireball.net/projects/markdown/syntax)
❌ 不推薦:通用文本
點擊 [這裡](https://daringfireball.net/projects/markdown/syntax) 查看文檔
2. 引用式鏈接用於長文檔
markdown
✅ 推薦:長文檔使用引用式
在我們的研究中,我們參考了 [Smith 等人的工作][smith2020]、
[Jones 的理論][jones2019] 和 [最新的行業報告][industry2021]。
[smith2020]: https://www.markdownlang.com/smith-2020-paper
[jones2019]: https://www.markdownlang.com/jones-theory
[industry2021]: https://www.markdownlang.com/industry-report-2021
3. 保持 URL 簡潔
markdown
✅ 推薦:使用短 URL 或自定義域名
[項目主頁](https://myproject.com)
✅ 可接受:長 URL 使用引用式
查看我們的 [詳細分析報告][detailed-report]
[detailed-report]: https://company.com/reports/2023/detailed-analysis-q4-performance-metrics
鏈接驗證
檢查鏈接有效性
定期檢查文檔中的鏈接:
markdown
<!-- 推薦添加注釋標記鏈接狀態 -->
[Active Link](https://www.google.com) <!-- ✓ 2023-01-15 -->
[Deprecated Link](https://old-site.com) <!-- ⚠️ 可能失效 -->
使用工具驗證
- linkchecker - 命令行鏈接檢查工具
- markdown-link-check - Node.js 鏈接驗證
- VS Code 插件 - 實時鏈接驗證
HTML 輸出
Markdown 鏈接轉換為 HTML:
markdown
[鏈接文本](https://www.example.com "標題")
轉換為:
html
<a href="https://www.example.com" title="標題">鏈接文本</a>
高級技巧
1. 條件鏈接
根據上下文動態決定是否添加鏈接:
markdown
在開發環境中,訪問 [本地服務器](http://localhost:3000)
在生產環境中,訪問 [線上服務器](https://production.example.com)
2. 鏈接分組
將相關鏈接分組管理:
markdown
<!-- 官方資源 -->
[官方網站][official]
[官方文檔][docs]
[官方博客][blog]
<!-- 社區資源 -->
[GitHub 倉庫][github]
[論壇討論][forum]
[社區博客][community]
[official]: https://www.markdownlang.com
[docs]: https://docs.example.com
[blog]: https://blog.example.com
[github]: https://github.com/example/project
[forum]: https://forum.example.com
[community]: https://community.example.com
3. 多語言鏈接
markdown
查看文檔:[English](README.md) | [中文](README-zh.md) | [日本語](README-ja.md)
實用示例
導航菜單
markdown
## 快速導航
**入門指南**
- [什麼是 Markdown](what-is-markdown.md)
- [安裝編輯器](install-editor.md)
- [第一個文檔](first-document.md)
**語法參考**
- [基本語法](basic-syntax.md)
- [擴展語法](extended-syntax.md)
- [最佳實踐](best-practices.md)
**資源鏈接**
- [官方網站](https://daringfireball.net/projects/markdown/)
- [在線編輯器](https://dillinger.io/)
- [語法檢查工具](https://markdownlint.github.io/)
參考文獻
markdown
## 參考文獻
本文檔基於以下資源編寫:
1. [Markdown 官方語法][markdown-syntax] - John Gruber
2. [CommonMark 規范][commonmark] - 標准化 Markdown
3. [GitHub Flavored Markdown][gfm] - GitHub 擴展語法
4. [Markdown Guide][markdown-guide] - 綜合學習資源
[markdown-syntax]: https://daringfireball.net/projects/markdown/syntax
[commonmark]: https://commonmark.org/
[gfm]: https://github.github.com/gfm/
[markdown-guide]: https://www.markdownguide.org/
工具推薦
markdown
## 推薦工具
### 編輯器
- [Typora](https://typora.io/) - 所見即所得編輯器
- [Mark Text](https://marktext.app/) - 免費開源編輯器
- [VS Code](https://code.visualstudio.com/) + Markdown 插件
### 在線工具
- [Dillinger](https://dillinger.io/) - 在線編輯器
- [StackEdit](https://stackedit.io/) - 功能豐富的在線編輯器
- [Markdown to HTML](https://markdowntohtml.com/) - 格式轉換
### 靜態站點生成器
- [VitePress](https://vitepress.dev/) - Vue 生態
- [Docusaurus](https://docusaurus.io/) - React 生態
- [GitBook](https://gitbook.com/) - 文檔平台
相關語法
練習
嘗試創建以下類型的鏈接:
- 一個包含多個外部鏈接的資源列表
- 一個使用引用式鏈接的技術文檔
- 一個帶有內部導航的長文檔
- 一個包含郵箱和網站鏈接的聯系頁面