@8btc/mditor 0.0.33 → 0.0.34

package/dist/ts/markdown/mathRender.d.ts

@@ -6,8 +6,8 @@ declare global {
 /**
  * 数学公式渲染入口
  *
- * 默认使用 MathJax 渲染（SVG 输出），并在需要时按需加载相关脚本与样式。
- * 支持通过 options.math.engine 切换为 KaTeX。
+ * 默认使用 KaTeX 渲染，并在需要时按需加载相关脚本与样式。
+ * 支持通过 options.math.engine 切换为 MathJax。
  *
  * 参数说明：
  * - element: 需要进行数学渲染的根容器（默认 document）

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@8btc/mditor",
-    "version": "0.0.33",
+    "version": "0.0.34",
     "description": "mditor, Md编辑器",
     "author": "wujie-vditor",
     "jsdelivr": "dist/index.min.js",

package/src/ts/markdown/mathRender.ts

@@ -50,8 +50,8 @@ const normalizeTex = (tex: string): string => {
 /**
  * 数学公式渲染入口
  *
- * 默认使用 MathJax 渲染（SVG 输出），并在需要时按需加载相关脚本与样式。
- * 支持通过 options.math.engine 切换为 KaTeX。
+ * 默认使用 KaTeX 渲染，并在需要时按需加载相关脚本与样式。
+ * 支持通过 options.math.engine 切换为 MathJax。
  *
  * 参数说明：
  * - element: 需要进行数学渲染的根容器（默认 document）
@@ -70,7 +70,7 @@ export const mathRender = (
     const defaultOptions = {
         cdn: Constants.CDN,
         math: {
-            engine: "MathJax",
+            engine: "KaTeX",
             inlineDigit: true,
             macros: {},
         },
@@ -180,39 +180,22 @@ export const mathRender = (
             next();
         };
         if (!window.MathJax) {
-            // typeset 设为 true 以正常完成公式渲染；elements 限定为传入的容器，外部使用本包时仅处理该容器，不影响编辑器以外的公式。
-            // 渲染时会将 startup.elements 临时设为传入的 element（当前预览/编辑容器），再 clear/updateDocument。
             window.MathJax = {
                 loader: {
                     paths: { mathjax: `${options.cdn}/dist/js/mathjax` },
                 },
                 startup: {
-                    typeset: true,
-                    elements: element instanceof HTMLElement ? [element] : [],
+                    typeset: false,
+                    elements:
+                        element instanceof HTMLElement ? [element] : [],
                 },
                 tex: {
-                    inlineMath: [
-                        ["$", "$"],
-                        ["\\(", "\\)"],
-                    ],
-                    displayMath: [
-                        ["$$", "$$"],
-                        ["\\[", "\\]"],
-                    ],
-                    processEscapes: true, // 允许转义字符（可选，确保分隔符不被误解析）
                     macros: options.math.macros,
-                    // 启用 ams 与 unicode，支持 \unicode 宏以渲染 ∯（oiint）
-                    packages: { "[+]": ["ams", "unicode", "noerrors"] },
-                },
-                // 关闭 MathJax 自带右键菜单，使用自定义菜单
-                options: {
-                    enableMenu: false,
                 },
             };
-            // https://github.com/Vanessa219/vditor/issues/1453
+            // https://github.com/Vanessa219/vditor/issues/1453 额外配置（packages、inlineMath、displayMath 等）由调用方通过 mathJaxOptions 传入
             Object.assign(window.MathJax, options.math.mathJaxOptions);
         }
-        // 循环加载会抛异常
         addScriptSync(
             `${options.cdn}/dist/js/mathjax/tex-svg-full.js`,
             "protyleMathJaxScript"
@@ -234,9 +217,7 @@ export const mathRender = (
                         const pre = mathElement.parentElement as HTMLElement;
                         pre.classList.add("vditor-wysiwyg__preview--math");
                     }
-                    // 绑定自定义右键菜单（编辑区生效，预览区自动跳过）
                     bindMathContextMenu(mathElement as HTMLElement);
-                    // 限定 document 范围为当前容器后再 clear/updateDocument，避免处理整页导致编辑器外的 $...$ 被重新渲染；不调用会导致同一公式被渲染 2 次
                     const startup = window.MathJax.startup;
                     const prevElements = startup.elements;
                     if (element instanceof HTMLElement) {
@@ -253,9 +234,10 @@ export const mathRender = (
                         errorTextElement &&
                         errorTextElement.textContent.trim() !== ""
                     ) {
-                        // 渲染失败时按普通文本展示原始内容
-                        mathElement.textContent = rawText;
-                        mathElement.className = "language-math";
+                        mathElement.innerHTML =
+                            errorTextElement.textContent.trim();
+                        mathElement.className =
+                            "language-math vditor-reset--error";
                     }
                     if (next) {
                         next();
@@ -264,7 +246,6 @@ export const mathRender = (
             );
         };
         window.MathJax.startup.promise.then(() => {
-            // 限定仅处理当前容器，避免组件内部或用户配置导致处理整页、影响编辑器以外的公式
             if (window.MathJax.startup) {
                 window.MathJax.startup.typeset = true;
                 window.MathJax.startup.elements =