降价和换行

Question

大部分时间Markdown文件都被视为源代码:它们在VCS中,它们参与拉取请求和/或评论,并且格式良好.就像在源代码中一样,我经常看到在特定长度插入的换行符 - 就像代码格式化程序一样.

许多编辑器根据当前窗口大小动态执行此操作.此外,Markdown主要用于生成HTML页面,PDF文档或其他格式.在这些情况下,手动插入的换行符通常会导致文本渲染混乱.

那么,将Markdown包装在特定的线长度某种反模式还是我错过了什么？

编辑:整个主题似乎是有争议的.即使是当前的CommonMark规范(v0.26)也有一定的范围:

没有前面有两个或多个空格或反斜杠的常规换行符(不在代码范围或HTML标记中)被解析为softbreak.(软件破解可以在HTML中呈现为行结尾或空格.结果在浏览器中将是相同的.在此处的示例中,将使用行结尾.)

[...]

符合标准的解析器可以在HTML中呈现换行符,作为换行符或空格.

渲染器还可以提供将软线断开渲染为硬换行的选项.

然而,约翰格鲁伯在2004年说过:

"一个或多个连续文本行"规则的含义是Markdown支持"硬包装"文本段落.这与大多数其他文本到HTML格式化程序(包括Movable Type的"转换换行符"选项)明显不同,后者将段落中的每个换行符转换为<br />标记.

当您确实想要<br />使用Markdown 插入break标记时,您将结束包含两个或更多空格的行,然后键入return.

是的,这需要更多的努力来创建一个<br />,但是一个简单的"每个换行是一个<br />"规则对Markdown不起作用.当您使用硬中断格式化时,Markdown的电子邮件风格的区块报价和多段列表项目效果最好 - 看起来更好.

Answer 1

大多数markdown渲染器都会忽略单个换行符，因此将文本环绕在约定的长度范围内不会影响渲染结果。但是，这可能会使代码更易于维护。这不仅不是一种反模式，有些项目甚至在其编码标准中也需要它（例如，我的头上有个libstoragemgmt-doc）。