Markdown文件中的GitHub相对链接

有没有办法创建网址锚， <a> Markdown文件中接到同一存储库和分支中的另一个文件（又称相对于当前分支的链接）？

例如，在master分支中，我有一个README.md文件，我想这样做：

# My Project
is really really cool. My Project has a subdir named myLib, see below.

## myLib documentation
see documentation [here](myLib/README.md)

这将允许我在同一个分支中将一个.md链接到另一个，而不必担心我所在的分支（避免使用包含github.com分支名称的绝对URL）。

这是我的意思的工作示例：

1. GOTO http://github.com/rynop/testRel，链接不起作用。
2. 转到http://github.com/rynop/testRel/blob/master/README.md，链接有效。

这是预期的，因为此时起始URL在分支中。现在，如何获取它以在存储库根目录下的README.md中获取当前分支？

更新：我针对此功能请求针对GitHub 开了一个问题。

2013年1月30日更新，即16个月后：

标记文件中的 GitHub Blog Post 相对链接：

从今天开始，GitHub支持标记文件中的相对链接。
现在，您可以直接在不同的文档文件之间链接，无论您是在GitHub本身上还是在本地使用不同的标记渲染器查看文档。

您需要链接定义的示例以及它们如何工作？这是您的Markdown。
而不是绝对链接：

[a link](https://github.com/user/repo/blob/branch/other_file.md)

…您可以使用相对链接：

[a relative link](other_file.md)

我们将确保它链接到 user/repo/blob/branch/other_file.md。

如果您正在使用类似的解决方法 [a workaround link](repo/blob/master/other_file.md)，则必须更新文档以使用新语法。

这也意味着您的文档现在可以轻松地独立存在，而不必总是指向GitHub。

2011年12月20日更新：

在GitHub上的标记问题84目前被关闭technoweenie，与评论：

我们尝试<base>为此添加标签，但它会导致网站上其他相对链接出现问题。

2011年10月12日：

如果您查看Markdown本身的原始资源README.md（！），似乎不支持相对路径。
您会找到类似的参考：

[r2h]: http://github.com/github/markup/tree/master/lib/github/commands/rest2html
[r2hc]: http://github.com/github/markup/tree/master/lib/github/markups.rb#L13

例如，您有一个类似以下的仓库：

project/
    text.md
    subpro/
       subtext.md
       subsubpro/
           subsubtext.md
       subsubpro2/
           subsubtext2.md

与subtext.mdin 的相对链接text.md可能如下所示：

[this subtext](subpro/subtext.md)

相对链接 subsubtext.mdin text.md可能如下所示：

[this subsubtext](subpro/subsubpro/subsubtext.md)

相对链接 subtext.mdin subsubtext.md可能如下所示：

[this subtext](../subtext.md)

相对链接 subsubtext2.mdin subsubtext.md可能如下所示：

[this subsubtext2](../subsubpro2/subsubtext2.md)

与text.mdin 的相对链接subsubtext.md可能如下所示：

[this text](../../text.md)

自2013年1月31日起，Github markdown 支持文件的相对链接。

[a relative link](markdown_file.md)

但是，此注释线程中已经讨论了一些缺陷。

作为替代方案，您可以使用Gitdown构造到存储库的完整URL，甚至使它们知道分支，例如

{"gitdown": "gitinfo", "name": "url"} // https://github.com/gajus/gitdown
{"gitdown": "gitinfo", "name": "branch"} // master

Gitdown是GitHub markdown预处理器。它简化了与维护GitHub存储库的文档页面相关的常见任务，例如，生成包含变量的目录，生成URL以及在处理输入时获取有关存储库本身的信息。Gitdown与您的构建脚本无缝集成。

我是Gitdown库的作者。

GitHub可以通过最少的工作使它变得更好。这是一种解决方法。

我想你想要更多类似的东西

[Your Title](your-project-name/tree/master/your-subfolder)

或指向自述文件本身

[README](your-project-name/blob/master/your-subfolder/README.md)

祝好运

只是想添加此内容，因为如果目标链接是名称中带有空格的目录，则上述解决方案均无效。如果目标链接是目录，并且有空间，那么即使使用\转义空格也不会在Github上呈现该链接。%20每个空间都只能使用对我有用的解决方案。

例如：如果目录结构是这个

Top_dir
|-----README.md
|-----Cur_dir1
      |----Dir A
           |----README.md
      |----Dir B
           |----README.md

要Dir A在README.md中提供链接，Top_dir可以执行以下操作：

[Dir 1](Cur_dir1/Dir%20A)

您可以链接到文件，但不能链接到文件夹，请记住，Github会/blob/master/在您的相对链接之前添加（并且文件夹缺少该部分，因此无法链接，也不能使用HTML链接）<a>标记 Markdown链接进行链接）。

因此，如果我们在中有一个文件myrepo/src/Test.java，则它将具有类似以下内容的网址：

https://github.com/WesternGun/myrepo/blob/master/src/Test.java

并将其链接到自述文件中，我们可以使用：

[This is a link](src/Test.java)

要么： <a href="src/Test.java">This is a link</a>。

（我想，master代表master分支，并且文件在另一个分支中时，它会有所不同。）

您可以使用来自仓库的根的相对URL <a href="">。假设您的存储库已命名testRel，请将以下内容输入testRel/README.md：

# My Project
is really really cool. My Project has a subdir named myLib, see below.

## myLib docs
see documentation:
    * <a href="testRel/myLib">myLib/</a>
    * <a href="testRel/myLib/README.md">myLib/README.md</a>

这个问题已经很老了，但它似乎仍然很重要，因为将readme.md的相对引用放在Github上的Wiki页面上并不容易。

我玩了一些，这个相对的链接似乎工作得很好：

[Your wiki page](../../wiki/your-wiki-page)

两者../将删除/blob/master/并以您的基础为起点。不过，除了Github之外，我没有在其他存储库上尝试过此操作（可能存在兼容性问题）。

我不确定是否在这里看到此选项。您可以/folder在存储库中创建一个，然后直接使用它：

[a relative link](/folder/myrelativefile.md)

不需要Blob，树或存储库名称，它的作用就像一个超级按钮。

如果您想要相对链接到GitHub上的Wiki页面，请使用以下命令：

Read here: [Some other wiki page](path/to/some-other-wiki-page)

如果要链接到存储库中的文件，可以说要引用一些头文件，并且Wiki页面位于Wiki的根目录，请使用以下命令：

Read here: [myheader.h](../tree/master/path/to/myheader.h)

最后一个理由是跳过带有“ ../”的“ / wiki”路径，并转到存储库树中的master分支而不指定存储库名称，该名称将来可能会更改。