如何让config.toml中的自定义变量在页面主体中正常显示？

以下是可能的原因及对应的解决方法：

1. 页面文件后缀不支持模板解析 #

Hugo仅对特定后缀的文件解析Go模板语法，比如.html（模板文件）、.md（需额外配置）。如果你的页面是.txt或其他非模板后缀文件，模板代码会被原样输出。

• 解决：将文件后缀改为.html（模板文件）或.md（内容文件）。

2. Markdown文件未开启模板解析权限 #

如果是在.md内容文件中写入模板代码，默认情况下Hugo不会解析其中的模板语法，需手动开启：
在config.toml中添加以下配置：

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true

该配置允许Hugo解析Markdown内容中的Go模板代码。

3. 模板代码被误放在代码块中 #

如果你的{{ .Site.Params.tdName }}被包裹在代码块标记（如```或`）内，Hugo会将其视为代码文本原样显示。

• 解决：移除代码块标记，直接将模板代码写在页面内容或模板的正常位置。

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