Github降价,尊重换行

时间:2018-06-26 18:38:34

标签: github markdown

我有一个txt文件,其中的列表看起来像这样

# Actors
Robert Mitchum
John Voight

# Musicians
Geddy Lee
Angus Young

我想将该文本添加到Github Wiki页面,并使其呈现如下: (我的txt文件中的每一行文本一行)

enter image description here

但是默认情况下,github的markdown风格会像这样

enter image description here

Github中是否有任何预定义的编辑模式可以实现此目的? 这是可用的编辑模式的列表

enter image description here

我总体上喜欢markdown,我只需要一种尊重换行符的格式。希望继续使用与markdown相同的符号。 (但是我基本上只需要#符号作为标题)。但是如果需要,我可以切换到完全不同的样式。 (将我的主题标签搜索并替换为其他符号会很容易)我只想要一种尊重换行符并且具有一些标题基本格式的格式。

3 个答案:

答案 0 :(得分:2)

在行尾添加 2个空格
像这样:

# Actors
Robert Mitchum  
John Voight  

演员

Robert Mitchum
约翰·沃伊特

音乐家

李小龙
安格斯·杨

答案 1 :(得分:1)

GitHub Flavored Markdown规范定义了两种换行符:

Hard Line Breaks

  

以两个开头的换行符(不在代码范围或HTML标记中)   或更多的空格并且不会出现在块的末尾被解析为   硬断行(在HTML中呈现为<br />标签)

Soft Line Breaks

  

常规换行符(不在代码段或HTML标记中)不是   前面两个或多个空格或反斜杠被解析为   软中断。 (软中断可以用HTML line ending或空格来表示。结果在浏览器中是相同的。   在此处的示例中,将使用line ending。)

您似乎希望将软换行符视为硬换行符。但是,请务必记住,Markdown是HTML的子集,并且是HTML中的浏览器collapse whitespace characters,其中包括制表符,空格,换行符和其他组成单个空格的字符。因此,尽管换行符保留在HTML输出中,但浏览器不会显示它。

鉴于上述情况,您可以使用硬换行符强制保留换行符(在HTML中插入了<br />标签)。像这样(用点代替空格进行演示):

# Actors
Robert Mitchum··
John Voight

# Musicians
Geddy Lee··
Angus Young

这将为您提供以下HTML:

<h1>Actors</h1>
<p>Robert Mitchum <br />
John Voight</p>
<h1>Musicians</h1>
<p>Geddy Lee <br />
Angus Young</p>

请注意在适当位置插入了<br />标签,这会导致强行换行。上面的呈现为:

  

演员

     

Robert Mitchum
  约翰·沃伊特

     

音乐家

     

李小龙
  安格斯·杨

但是您可能想要单独的段落

当然,这确实将两个名称插入到同一段中,这与问题的内容是一致的。但是,如果两个名称实际上应该在单独的段落中,则只需在它们之间插入一个空行。实际上,您实际上也应该在标题和段落之间插入空白行。像这样:

# Actors

Robert Mitchum

John Voight

# Musicians

Geddy Lee

Angus Young

此HTML的结果:

<h1>Actors</h1>
<p>Robert Mitchum</p>
<p>John Voight</p>
<h1>Musicians</h1>
<p>Geddy Lee</p>
<p>Angus Young</p>

并呈现为:

  

演员

     

Robert Mitchum

     

约翰·沃伊特

     

音乐家

     

李小龙

     

安格斯·杨

答案 2 :(得分:0)

这与Markdown语法有关。 如果您使用的是StackOverflow,您可能会在实时预览中注意到,文本之间的换行符只能生成一个空格,而 double 换行符可以生成一个真实的换行符。您可以参考GitHub Wiki: adam-p/markdown-here有关换行符。

对于原始答案,添加新行即可解决此问题。

# Actors
Robert Mitchum

John Voight

# Musicians
Geddy Lee

Angus Young

这将在下面显示文本:

演员

Robert Mitchum

约翰·沃伊特

音乐家

李小龙

安格斯·杨