Hexo Next主题行内$$公式渲染失败问题求助

已执行操作 #

• 包管理操作：卸载hexo-renderer-marked，安装hexo-renderer-pandoc
• 站点_config.yml配置：

  per_page:true
    mathjax:
      enable: true
  

• 文章头部设置：mathjax: true
• 怀疑方向：pandoc安装环境异常导致渲染失败

排查与修复步骤 #

1. 修正站点配置的缩进错误 #

当前配置中mathjax被错误嵌套在per_page节点下，会导致配置不生效。正确层级如下：

per_page: true
mathjax:
  enable: true
  # 强制开启行内公式支持可添加此配置
  inline: true

2. 确认系统级Pandoc已安装 #

hexo-renderer-pandoc依赖本地系统安装的Pandoc，而非仅npm包。执行命令检查：

pandoc --version

若提示命令不存在，需安装系统级Pandoc（推荐版本≥2.0）。

3. 测试Pandoc自身的公式渲染能力 #

创建测试文件test.md，内容：

行内公式测试：$$E=mc^2$$

执行命令生成HTML：

pandoc test.md -o test.html

打开test.html查看公式是否转为MathJax格式。若未渲染，说明Pandoc版本或配置有问题，需重新安装/升级。

4. 清除Hexo缓存并重新生成 #

缓存可能残留旧渲染规则，执行：

hexo clean && hexo generate && hexo server

刷新页面验证公式显示效果。

5. 检查Next主题的MathJax配置 #

部分Next版本需在主题_config.next.yml中单独开启：

math:
  enable: true
  mathjax:
    enable: true
    inline: true

确保主题配置与站点配置的MathJax开关一致。

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