Markdown 文件中的 GitHub 相对链接
有没有办法从 Markdown 文件中创建 URL 锚点 <a> 链接到同一存储库和分支中的另一个文件（也就是相对于当前分支的链接）？
例如，在主分支中，我有一个 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）。
这是我的意思的一个工作示例：
转到 http://github.com/rynop/testRel，链接不起作用。转到 http://github.com/rynop/testRel/blob/master/README.md，链接有效。
这是预期的，因为此时起始 URL 位于分支中。现在如何让它在存储库根目录的 README.md 中获取当前分支？
更新：针对此功能请求，我针对 GitHub 打开了一个 issue。
2013 年 1 月 30 日更新，16 个月后：
GitHub 博客文章 标记文件中的相对链接：
从今天开始，GitHub 支持标记文件中的相对链接。现在，您可以在不同的文档文件之间直接链接，无论您是在 GitHub 本身上查看文档，还是在本地查看文档，都可以使用不同的标记渲染器。您想要链接定义的示例以及它们如何工作？这里有一些 Markdown 给你。而不是绝对链接：[a link](https://github.com/user/repo/blob/branch/other_file.md) ...您可以使用相对链接：[a relative link](other_file.md) [一个相对链接](path%20with%20spaces/other_file.md)，我们将确保它链接到 user/repo/blob/branch/other_file.md。如果您使用的是 [a workaround link](repo/blob/master/other_file.md) 之类的解决方法，则必须更新文档以使用新语法。这也意味着您的文档现在可以很容易地独立存在，而不必总是指向 GitHub。
也很有用：当链接以/开头时，它是相对于存储库的根目录（不管markdown文件是否嵌套在子目录中）
2011 年 12 月 20 日更新：
GitHub markup issue 84 目前已由 technoweenie 关闭，评论如下：
我们尝试为此添加
2011 年 10 月 12 日：
如果您查看 Markdown 本身的 raw source of the 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
如 InvisibleWolf 的 answer 所述，如果目标链接是一个目录并且它有空间，那么您需要为每个空间使用 %20。
例如，您有一个如下所示的 repo：
project/
text.md
subpro/
subtext.md
subsubpro/
subsubtext.md
subsubpro2/
subsubtext2.md
text.md 中到 subtext.md 的相对链接可能如下所示：
[this subtext](subpro/subtext.md)
text.md 中到 subsubtext.md 的相对链接可能如下所示：
[this subsubtext](subpro/subsubpro/subsubtext.md)
subsubtext.md 中到 subtext.md 的相对链接可能如下所示：
[this subtext](../subtext.md)
subsubtext.md 中到 subsubtext2.md 的相对链接可能如下所示：
[this subsubtext2](../subsubpro2/subsubtext2.md)
subsubtext.md 中到 text.md 的相对链接可能如下所示：
[this text](../../text.md)
GitHub 可以通过最少的工作使这变得更好。这是一个解决方法。
我想你想要的东西更像
[Your Title](your-project-name/tree/master/your-subfolder)
或指向自述文件本身
[README](your-project-name/blob/master/your-subfolder/README.md)
截至 2013 年 1 月 31 日，Github 降价supports relative links to files。
[a relative link](markdown_file.md)
但是，discussed in this comment thread存在一些缺陷。
作为替代方案，您可以使用 Gitdown 来构造 full URLs to the repository 甚至让它们知道分支，例如
{"gitdown": "gitinfo", "name": "url"} // https://github.com/gajus/gitdown
{"gitdown": "gitinfo", "name": "branch"} // master
Gitdown 是一个 GitHub 降价预处理器。它简化了与维护 GitHub 存储库的文档页面相关的常见任务，例如生成目录（包括变量）、生成 URL 以及在处理输入时获取有关存储库本身的信息。 Gitdown 与您的构建脚本无缝集成。
我是 Gitdown 库的作者。
只是想添加它，因为如果目标链接是名称中带有空格的目录，则上述解决方案都不起作用。如果目标链接是一个目录并且它有空间，那么即使使用 \ 转义空间也不会在 Github 上呈现链接。唯一对我有用的解决方案是对每个空间使用 %20。
eg：如果目录结构是这样的
Top_dir
|-----README.md
|-----Cur_dir1
|----Dir A
|----README.md
|----Dir B
|----README.md
要在 Top_dir 中的 README.md 中链接到 Dir A，您可以这样做：
[Dir 1](Cur_dir1/Dir%20A)
您可以链接到文件，但不能链接到文件夹，请记住，Github 会在您的相对链接之前添加 /blob/master/（并且文件夹缺少该部分，因此它们无法链接，无论是 HTML <a> 标记还是 Markdown 链接） .
因此，如果我们在 myrepo/src/Test.java 中有一个文件，它的 URL 如下：
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 分支，当文件在另一个分支中时它会有所不同。）
这个问题已经很老了，但它似乎仍然很重要，因为将 readme.md 中的相关引用放到 Github 上的 wiki 页面并不容易。
我玩了一下，这个相对链接似乎工作得很好：
[Your wiki page](../../wiki/your-wiki-page)
两个 ../ 将删除 /blob/master/ 并使用您的基地作为起点。不过，我还没有在 Github 以外的其他存储库上尝试过这个（可能存在兼容性问题）。
您可以将存储库根目录中的相对 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>
我不确定我是否在此处看到此选项。您可以在存储库中创建一个 /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”路径，并在不指定存储库名称的情况下转到存储库树中的主分支，这可能会在未来发生变化。
只需遵循以下格式。
[TEXT TO SHOW](actual URL to navigate)
您还可以在底部插入链接（相对或绝对）以减少文本的混乱。对于重复链接，它也是一个不错的选择。
This is [my linked text].
[my linked text]: relative/path/in/repo/to/file.txt "Optional title for mouse hover"
Markdown 文件中 Github 目录链接中的行为可能会让人头疼。
所有文件的 url 都以 blob 开头，
blob/<branch>/<path>/<fileName>
而目录有一个以树开头的url：
tree/<branch>/<path>
因此，没有指向目录的相对链接应该起作用。它指向一个以 blob 开头的 url。神奇地 Github 会自动将一些相对路径更改为树路径。不幸的是，没有包含“..”的网址
我调查了一些时间来检查 https://github.com/fluentcodes/GitSamples-GIT/tree/github-readme-links 上的 Github 目录链接的奇怪行为。
[Welcome](./wiki/Hello)有效，其中 Hello 是同一 repo 中的另一个 wiki 页面。/开头时，它是相对于存储库的根目录（不管 Markdown 文件是否嵌套在子目录中）。