Skip to main content

自动链接引用和 URL

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

谁可以使用此功能?

Markdown 可用于 GitHub Web 界面。

URL

GitHub 通过标准 URL 自动创建链接。

Visit https://github.com

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

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

议题和拉取请求

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

注意

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

引用类型原始引用短链接
问题或拉取请求 URLhttps://github.com/jlord/sheetsee.js/issues/26
          [#26](https://github.com/jlord/sheetsee.js/issues/26)

| # 和问题或拉取请求编号 | #26 | #26 | | GH- 和问题或拉取请求编号 | GH-26 | GH-26 | | Username/Repository# 和问题或拉取请求编号 | jlord/sheetsee.js#26 | jlord/sheetsee.js#26 | Organization_name/Repository# 和问题或拉取请求编号 | github-linguist/linguist#4039 | github-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/a5c3785ed8d6a35868bc169f07e40e889087fd2e
          [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |

| 安全哈希算法 (SHA) | a5c3785ed8d6a35868bc169f07e40e889087fd2e | a5c3785 | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | jlord@a5c3785 | Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | jlord/sheetsee.js@a5c3785 |

引用提交 SHA 的故障排除

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

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

默认情况下,引用将生成反向链接。 例如,如果手动在拉取请求中链接到议题,则将自动在议题中生成反向链接到该拉取请求的另一个链接__。 为避免此行为,在引用中构建 URL 时,可以使用 redirect.github.com 而不是 github.com。 如果在引用链接中使用 redirect.github.com URL,则在悬停时将不会显示弹出窗口。

注意

在具有数据驻留的 GitHub Enterprise Cloud (ghe.com) 环境中,此方法不受支持。

其他阅读材料

  •         [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)