跳至主要内容

自动链接的引用和 URL

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

谁可以使用此功能?

Markdown 可在 GitHub 网页界面中使用。

URL

GitHub 会自动为标准 URL 创建链接。

访问 https://github.com

Screenshot of rendered GitHub Markdown showing how a URL is displayed as a blue clickable link, "Visit 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。例如,我们公开的 docs 仓库中标签 “enhancement” 的 URL 为

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

注意

如果标签名称包含句点(.),则标签不会从标签 URL 自动渲染。

提交 SHA

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

引用类型原始引用短链接
提交 URLhttps://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
SHAa5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
用户@SHAjlord@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord@a5c3785
用户名/仓库@SHAjlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord/sheetsee.js@a5c3785

排查提交 SHA 引用问题

在提交信息中引用私有仓库的提交时,只有当该提交的作者或提交者中至少有一人拥有对该提交的读取权限时,提交 SHA 才会被短链接。

如果为仓库配置了自定义自动链接引用,则对外部资源(如 JIRA 议题或 Zendesk 工单)的引用会转换为短链接。要了解仓库中可用的自动链接,请联系具备仓库管理员权限的人员。更多信息,请参阅 配置自动链接以引用外部资源

默认情况下,引用会生成一个反向链接。例如,在拉取请求中手动链接到议题时,系统会自动在该议题中生成指向拉取请求的链接。若想避免此行为,可以在构造引用的 URL 时使用 redirect.github.com 替代 github.com。如果在引用链接中使用了 redirect.github.com URL,悬停时不会出现弹出窗口。

注意

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

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.