在 GitHub wiki 中,Markdown 的绝对链接指向 raw.githubusercontent

In GitHub wiki, absolute links to Markdown leads to raw.githubusercontent

这是我的问题: 我想写一个 GitHub wiki,其中到其他页面的超文本 links 是绝对路径(我有子文件夹等等。在我的情况下,这样会更容易)。

\[label](https://github.com/repo/../fileName.md).

当我点击 link 时,它会转到正确的页面,但没有任何 Markdown 格式的解释。我怎样才能写这个 link 以便它会导致一个解释页面?

我刚得到答案:

如果我们希望文件被解释为 Markdown 文件,则不需要任何文件路径。只需写下名称,GitHub wiki 将完成剩下的工作。一旦你写了一个路径(相对或绝对),GitHub 将把它解释为 raw.githubusercontent.

当 link 访问 GitHub wiki 中路径位于 https://github.com/<org>/<repo>/wiki/... 下方的另一个页面时,您必须省略任何额外的路径信息,以及 .md扩展名并仅使用文件名。

如果包含 .md 扩展名,

GitHub 将提供原始文本。如果您不使用扩展名,则文件将呈现为 HTML.

此行为仅在 link 访问另一个 页面 时适用。当 linking 到 image 时,行为是不同的;您必须包含任何额外的路径信息 and/or 文件扩展名。

例如[API Reference](API-Reference) 等同于 https://github.com/<org>/<repo>/wiki/API-Reference 并且可以 link 到文件中描述的页面 https://github.com/<org>/<repo>/wiki/api/API-Reference.md - 虽然后者 link 将 return 原始文件内容。

如果您 link 到当前 GitHub wiki 之外的页面,行为又会有所不同。例如即使使用 .md 扩展名,repo 本身中的 README.md 文件也会呈现为 html。 (事实上​​ ,我怀疑 link 如果您不使用扩展名是否会起作用。)这样做的原因是它是一个 wiki 功能,允许您在没有扩展名的情况下访问文件; wiki 无法影响外部网页的呈现行为。