如何在markdown .md或.Rmd文件中创建一个github永久链接?

时间:2018-04-04 12:36:23

标签: github

如何创建.md或.Rmd文件中特定行的永久链接,如README.md?

这些文件在github中的呈现方式不同,所以当我点击它们时,我没有看到通常的行号编辑器,我可以点击一行并要求它给我所选行的永久链接, as described here

4 个答案:

答案 0 :(得分:5)

是的,您可以通过转到文件的Blame视图来链接到Markdown文件中的特定行。

Click the Blame button

然后,按 y 以获取permalink to the version of the file that you see now。如果文件发生更改,移动,重命名或删除,这将确保该链接仍然存在。

这时,您可以单击一个链接,或按住Shift并单击一系列行,然后URL会自动更新。

这里是example link

答案 1 :(得分:0)

您无法链接到行号,因为行号锚点由GitHub代码预览界面提供。因为,正如您所提到的,降价文件的呈现方式不同,因此它们没有您要查找的行号锚点。

但是,您可以链接到标题(以一个或多个#开头的任何内容。)将鼠标悬停在标题上以显示链接图标:

GitHub header link

然后右键单击链接图标和“复制链接地址”。

如果您在与目标链接相同的markdown文件中工作,则可以使用markdown anchor syntax[link name](#anchor-name-with-hyphens)

答案 2 :(得分:0)

更新:

自2018年10月1日起,由于RMarkdown文件为no longer rendered to html by GitHub。因此,您可以像使用典型文本文件一样为RMarkdown文件创建永久链接。只需在GitHub中查看文件,选择要创建永久链接的行,然后单击“ ...”->“复制永久链接”,如下所示:

enter image description here

答案 3 :(得分:-1)

使用named destination anchor。它们可以用作同一HTML文档或其他文档中的链接目标。

放线

<a name="my-anchor"></a>

您想要作为链接目的地的行上方。

为空时,<a>元素不会显示,但它仍然存在于生成的HTML中。

您的永久链接是文档的网址(在Github上),后跟#my-anchor

 <a href="http://github.com/user/project/blob/master/Readme.md#my-anchor">Go to line 42</a>

如果您所需的链接目的地是Readme.md中的标题,则Markdown引擎已为其创建了命名锚点。您所要做的就是将标题悬停在Github上的渲染页面中,然后单击左侧标题旁边显示的链接链。然后,您将从浏览器的位置栏中获取网址。

请注意,此自动生成的目标锚点是使用标题的内容生成的。当标题内容发生变化时,它会发生变化,您最终会断开链接。