解决hugo渲染html换行和Typora本地配置换行不一致的问题

问题

在Typora中使用shift+Enter进行软换行,但hugo渲染网页时不会换行。只能使用2个空格+Enter进行换行/使用<br>进行换行。

原因

这是因为Hugo 默认渲染器(Goldmark)的规范行为,和 Typora 的本地配置不同。
Hugo 遵循标准的 CommonMark 规范:单纯的回车(软换行)只会被当作空格处理,必须在行尾加 2 个空格才会渲染成 <br> 换行。

解决办法

修改 Hugo 配置文件,打开你的 hugo.yaml文件,添加以下配置:

1
markup.goldmark.renderer.hardWraps: true
image-20260324210341486

效果:之后在 Typora 里按 Shift + Enter,Hugo 渲染后就能正常换行

最后更新于 2026-03-24