Hugo 0.140版本换行行为变更,如何恢复旧版逻辑?
如何恢复Hugo 0.140之前的Markdown换行行为
Hugo 0.140版本调整了默认Markdown渲染器(Goldmark)的换行处理逻辑,将单文本行的软换行默认转为HTML的<br>标签,这和旧版及GitHub Flavored Markdown的行为不一致。要恢复旧版仅在两个以上换行+空格才生成页面换行的行为,可通过以下配置实现:
全局生效配置
在站点根目录的config.toml(或对应格式的配置文件)中添加以下内容:
[markup.goldmark.renderer.paragraph] softWrap = false
如果是config.yaml格式:
markup: goldmark: renderer: paragraph: softWrap: false
单页面生效配置
如果仅需针对特定页面恢复旧行为,可在该页面的Front Matter中添加:
markup: goldmark: renderer: paragraph: softWrap: false
原理说明
Hugo默认使用的Goldmark渲染器,在0.140版本中将softWrap的默认值从false修改为true。设置softWrap = false后,Markdown文本中的单换行不会被渲染为HTML换行,仅当存在两个连续换行(即段落分隔)时才会生成页面换行,与旧版Hugo及GitHub Markdown行为一致。
内容的提问来源于stack exchange,提问作者Jakob
相关产品推荐
相关产品推荐

