如何配置R Markdown以在HTML渲染中使用MathJax的textmacros扩展？

问题核心 #

需要让LaTeX文本命令（如\texttt{my\_var}）在PDF和HTML输出中表现一致：PDF中会渲染为my_var，但默认MathJax HTML输出会保留下划线，启用textmacros扩展可解决此问题，但原配置方法无效。

根本原因 #

原header.html使用了MathJax 2的旧语法（MathJax.Hub.Config），而当前RStudio版本（2022.12.0）的rmarkdown默认使用MathJax 3，语法不兼容导致配置失效。

正确解决方案 #

1. 修改header.html配置（MathJax 3语法） #

替换原有内容为：

<script>
MathJax = {
  tex: {
    packages: {'[+]': ['textmacros']}
  }
};
</script>

2. 保持R Markdown文档YAML不变 #

原文档的YAML配置无需修改：

---
title: "My Doc"
output:
  html_document:
    math_method: mathjax
    includes:
      in_header: header.html
  pdf_document:
    latex_engine: pdflatex
---

Test formula: $\texttt{my\_var} * 2 + 1$

3. 验证效果 #

编织后HTML中的$\texttt{my\_var}$会和PDF一样渲染为my_var，下划线自动去除，无需区分环境写重复代码。

补充说明 #

• 若仍不生效，可强制指定MathJax 3的完整加载源（修改header.html为以下内容），确保加载包含textmacros扩展的版本：

<script>
MathJax = {
  tex: {
    packages: {'[+]': ['textmacros']}
  }
};
</script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js"></script>

• 避免使用MathJax 2的旧配置语法，确保与rmarkdown的默认MathJax版本兼容。

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