Skip to main content

自动链接引用和 URL

对 URL、议题、拉取请求和提交的引用会自动缩短并转换为链接。

URL

GitHub 自动从标准 URL 创建链接。

Visit https://github.com

呈现的 GitHub Markdown 的屏幕截图,其中显示了以“http”开头的 URL 如何变为可单击的蓝色链接。 文本显示“访问 https://github.com”。

有关创建链接的详细信息,请参阅“基本撰写和格式语法”。

议题和拉取请求

在 GitHub 上的对话中,对议题和拉取请求的引用将自动转换为缩短的链接。

注意: 在存储库的 wiki 或文件中没有创建自动链接的引用。

引用类型原始引用短链接
问题或拉取请求 URLhttps://github.com/jlord/sheetsee.js/issues/26#26
# 和问题或拉取请求编号#26#26
GH- 和问题或拉取请求编号GH-26GH-26
Username/Repository# 和问题或拉取请求编号jlord/sheetsee.js#26jlord/sheetsee.js#26
Organization_name/Repository# 和问题或拉取请求编号github-linguist/linguist#4039github-linguist/linguist#4039

如果在列表中引用问题、拉取请求或讨论,则引用将展开以显示标题和状态。 有关任务列表的详细信息,请参阅“关于任务列表”。

标签

在 Markdown 中引用标签的 URL 时,标签会自动呈现。 仅呈现同一存储库的标签,指向不同存储库标签的 URL 将呈现为任何 URL

通过导航到标签页并单击标签,可找到标签的 URL。 例如,公共文档存储库中标签“增强”的 URL 为

https://github.com/github/docs/labels/enhancement

注意:如果标签名称包含句点 (.),则标签不会从标签 URL 自动呈现。

提交 SHA

对提交 SHA 哈希的引用会自动转换为指向 GitHub 上提交的短链接。

引用类型原始引用短链接
提交 URLhttps://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
SHAa5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
User@SHAjlord@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord@a5c3785
Username/Repository@SHAjlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord/sheetsee.js@a5c3785

引用提交 SHA 的故障排除

从提交消息内部的专用存储库引用提交时,仅当提交的至少一个作者或提交者对所引用的提交具有读取访问权限时,提交 SHA 才会进行短链接。

如果自定义自动链接引用配置用于仓库,则对外部资源(如 JIRA 议题或 Zendesk 事件单)的引用将转换为缩短的链接。 要了解在您的仓库中哪些自动链接可用,请联系拥有仓库管理员权限的人。 有关详细信息,请参阅“配置自动链接以引用外部资源”。

延伸阅读