这是我的问题: 我想编写一个 GitHub wiki,其中指向其他页面的超文本链接是绝对路径(我有子文件夹等。在我的情况下,这样会更容易)。
即\[label](https://github.com/repo/../fileName.md)
。
当我点击链接时,它会转到正确的页面,但没有任何 Markdown 格式的解释。我怎样才能写这个链接,以便它会导致一个解释的页面?
最佳答案
当使用位于 https://github.com/<org>/<repo>/wiki/...
下方的路径链接到 GitHub wiki 中的另一个页面时您必须省略任何额外的路径信息,以及 .md
扩展名并仅使用文件名。
如果您包含 .md
,GitHub 将提供原始文本扩大。如果您不使用扩展名,那么文件将呈现为 HTML。
此行为仅在链接到另一个页面 时适用。当链接到一个图像时,行为是不同的;您必须包含任何额外的路径信息和/或文件扩展名。
例如[API Reference](API-Reference)
相当于https://github.com/<org>/<repo>/wiki/API-Reference
并可以链接到文件中描述的页面 https://github.com/<org>/<repo>/wiki/api/API-Reference.md
- 尽管后一个链接将返回原始文件内容。
如果您链接到当前 GitHub wiki 之外的页面,行为又会有所不同。例如即使使用 .md
,repo 本身中的 README.md 文件也会呈现为 html扩大。 (事实上,我怀疑如果您不使用扩展名,链接是否有效。)这样做的原因是它是一个 wiki 功能,允许您在没有扩展名的情况下访问文件; wiki 无法影响外部网页的呈现行为。
关于github - 在 GitHub wiki 中,Markdown 的绝对链接指向 raw.githubusercontent,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/34804531/