无格式的链接列表在github markdown上不一致

时间:2015-12-10 13:59:57

标签: github markdown github-flavored-markdown

我想在github wiki /文档上有一个没有样式的链接列表。我给出adam-p's markdown cheatsheet的假设是,单击<enter>键就会破坏这条线。

但是这个:

[link1](#link1)
[link2](#link2)
[link3](#link3)

在Github wiki页面上显示如下:

enter image description here enter image description here 但是在“问题”页面上,它呈现的方式不同:

enter image description here enter image description here

我需要一个块中显示的无样式链接列表。为什么在Github网站上不一致?这是一个错误还是我合法地需要使用类似<br>标签的东西?

更新

在每行的末尾添加2个空格可以破坏该行,但它似乎也会破坏链接。

enter image description here

enter image description here

更新2

通过与@Chris聊天并进一步调查结果发现只有在编辑页面而不是创建页面时才会显示损坏的链接问题。完全相同的md渲染得很好。因此,我们将其归结为特殊情况。

1 个答案:

答案 0 :(得分:1)

发生这种情况的原因可能是the API documentation for the Markdown rendering service上显示的内容。我把最重要的部分加在了一边:

  

渲染模式。可以是:

     
      
  • ViewModel将文档呈现为纯Markdown,就像呈现README文件一样

  •   
  • markdown将文档呈现为用户内容, 例如,例如用户评论或提出问题。在GFM模式下,始终会考虑硬换行,并且相应地链接问题和用户提及。

  •   

因此,出于某种原因,GitHub选择支持两种略有不同的模型,具体取决于Markdown代码的存在位置。

  

我需要一个块中显示的无样式链接列表。

假设这意味着您需要在问题中看到的行为,每个链接出现在新行上,您可以通过跟踪每个带有两个尾随空格的项目来实现它。这是how <br> tags are represented in the original Markdown implementation

  

当你想要使用Markdown插入gfm中断标记时,你会结束一个包含两个或更多空格的行,然后输入return。

这应该适用于GitHub上呈现Markdown的任何地方。

相关问题