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

标签 github markdown wiki

这是我的问题: 我想编写一个 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/

相关文章:

git - 克隆 CodeIgniter 框架来构建我的网站

github - 如何在现有存储库中添加空文件夹?吉图布

Git pull 在提交日志中产生无关的 "Merge branch"消息

javascript - 在自定义的 release.yml 文件中获取针对版本号的 git 更改

r - 在 R Markdown 中将文本方向更改为从右到左

wordpress - 如何在 Wordpress 中使用 wiki 标记

c# - 使用 Regex 解析 URL,忽略 Markdown 中的代码块和代码片段

latex - 从 markdown 4th header 生成 pdf 的 Pandoc 呈现方式不同

vim - 如何结合 vim wiki 插件的两个功能?

github - GitHub 中的文档选项