能否将MathJax导入本地HTML引用的JS文件中？

问题背景 #

尝试将MathJax官网提供的tex-mml-chtml配置从HTML直接导入拆分到本地index.html和main.js文件后，出现控制台错误与公式显示异常，需排查是否支持该使用方式，以及具体原因（如CORS、JS模块错误或MathJax设计限制）。

现有代码 #

index.html

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width">
  <title>MathJax example</title>
  <script id="main"
          type="module"
          src="main.js">
  </script>
</head>

<body>
<p>
  When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c = 0\) and they are
  \[x = {-b \pm \sqrt{b^2-4ac} \over 2a}.\]
</p>
</body>
</html>

main.js

import * as jax from "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js";

原因分析 #

1. 脚本类型不匹配：tex-mml-chtml.js是MathJax官方封装的自执行入口脚本，而非标准ES模块。它内部没有定义可供import导出的变量或方法，直接用ES模块语法导入会触发模块解析错误。
2. 自执行逻辑失效：该脚本原本会自动完成初始化、扫描DOM中的数学公式并渲染，但在ES模块环境下，其自执行逻辑无法正确触发DOM扫描流程，导致公式无法渲染。
3. 无CORS问题：CDN提供的MathJax脚本已配置正确的CORS响应头，此场景下CORS并非报错原因。

解决方法 #

方法一：使用官方推荐的直接引入方式（最简单） #

将tex-mml-chtml.js直接通过script标签引入HTML，无需拆分到模块文件：

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width">
  <title>MathJax example</title>
  <script src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
</head>
<body>
<p>
  When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c = 0\) and they are
  \[x = {-b \pm \sqrt{b^2-4ac} \over 2a}.\]
</p>
</body>
</html>

方法二：通过ES模块API手动配置（适用于自定义场景） #

若必须使用ES模块方式，需导入MathJax核心模块并手动完成初始化与渲染：

修改后的main.js

import { MathJax } from 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/core.js';
import { TeX } from 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/input/tex.js';
import { CHTML } from 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml.js';
import { browserAdaptor } from 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/adaptors/browserAdaptor.js';
import { RegisterHTMLHandler } from 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/handlers/html.js';

// 注册HTML渲染适配器
const adaptor = browserAdaptor();
RegisterHTMLHandler(adaptor);

// 配置MathJax的输入输出规则
MathJax.config({
  input: {
    TeX: {
      inlineMath: [['\\(', '\\)']], // 匹配行内公式标记
      displayMath: [['\\[', '\\]']] // 匹配块级公式标记
    }
  },
  output: {
    CHTML: {} // 使用HTML-CSS输出格式
  }
});

// 初始化并渲染当前页面的数学公式
MathJax.startup.document(document).render();

对应的index.html

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width">
  <title>MathJax example</title>
  <script type="module" src="main.js"></script>
</head>
<body>
<p>
  When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c = 0\) and they are
  \[x = {-b \pm \sqrt{b^2-4ac} \over 2a}.\]
</p>
</body>
</html>

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