如何让kramdown或Nanoc生成<br>而非<br />作为换行标签？

要让kramdown生成符合HTML5规范的<br>而非XHTML的<br />，核心是指定kramdown的输出格式为html5，具体在Nanoc中有两种配置方式：

方式一：通过nanoc.yaml全局配置 #

在项目根目录的nanoc.yaml文件中，为markdown文件的kramdown过滤器添加output_format选项：

text_extensions:
  md:
    filter: kramdown
    options:
      output_format: html5

方式二：通过Rules文件单独配置 #

如果需要针对特定路径的文件设置，可在Rules文件中修改编译规则，为kramdown过滤器指定参数：

compile '/**/*.md' do
  filter :kramdown, output_format: 'html5'
  layout '/default.*'
end

配置完成后，kramdown会自动将Markdown中行尾双空格触发的换行转换为<br>，同时其他空元素（如<img>、<hr>）也会遵循HTML5规范去掉尾随斜杠，解决HTML5验证器的报错问题。

内容的提问来源于stack exchange，提问作者Dave Everitt