You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 06:22:33