[v2.0.39] Add native Typst math output format (LaTeX/MathML → Typst)

.npmignore

@@ -2,6 +2,7 @@
 /node_modules
 /examples
 /tests
+/pr-specs
 webpack.config.js
 webpack.dev.js
 .gitignore

README.md

@@ -268,13 +268,14 @@ class ConvertForm extends React.Component {
 
 #### [Example of Latex to mathml/asciimath/tsv conversion](https://github.com/Mathpix/mathpix-markdown-it/tree/master/examples/react-app/use-parseMarkdownByHTML-method)
 
-Rendering methods have the ability to convert `Latex` representation to such formats as: `mathml`, `asciimath`, `tsv`
+Rendering methods have the ability to convert `Latex` representation to such formats as: `mathml`, `asciimath`, `typst`, `tsv`
 
 ```js
 const options = {
       outMath: { //You can set which formats should be included into html result
         include_mathml: true,
         include_asciimath: true,
+        include_typst: true,
         include_latex: true,
         include_svg: true, // sets in default
         include_tsv: true,
@@ -291,6 +292,8 @@ For `Latex` formulas, the result will be:
 <span class="math-inline">
     <mathml style="display: none">...</mathml>
     <asciimath style="display: none">...</asciimath>
+    <typstmath style="display: none">...</typstmath>
+    <typstmath-inline style="display: none">...</typstmath-inline>
     <latex style="display: none">...</latex>
     <mjx-comtainer class="MathJax" jax="SVG">..</mjx-comtainer>
 </span>
@@ -317,6 +320,14 @@ For `Latex` formulas:
        "type": "asciimath",
        "value": "x^(x)"
      },
+    {
+       "type": "typst",
+       "value": "x^x"
+     },
+    {
+       "type": "typst_inline",
+       "value": "x^x"
+     },
     {
        "type": "latex",
        "value": "x^x"
@@ -420,6 +431,76 @@ const parsed = MathpixMarkdownModel.parseMarkdownByHTML(html, false);
 ```
 
 
+### Latex to Typst math conversion
+
+You can convert LaTeX math directly to [Typst](https://typst.app/) math notation:
+
+```js
+const { MathJax } = require('mathpix-markdown-it/lib/mathjax/index.js');
+
+const result = MathJax.TexConvertToTypstData('\\frac{a}{b}');
+// result = { typstmath: 'frac(a, b)', typstmath_inline: 'frac(a, b)' }
+// result.error is undefined (set only when LaTeX is invalid)
+```
+
+Conversion examples — note how Typst uses function-call syntax instead of LaTeX backslash commands:
+
+```js
+// Fractions: \frac{}{} → frac()
+MathJax.TexConvertToTypstData('\\frac{x+1}{x-1}');
+// { typstmath: 'frac(x + 1, x - 1)', typstmath_inline: 'frac(x + 1, x - 1)' }
+
+// Roots: \sqrt → sqrt(), \sqrt[n] → root()
+MathJax.TexConvertToTypstData('\\sqrt[3]{x}');
+// { typstmath: 'root(3, x)', typstmath_inline: 'root(3, x)' }
+
+// Matrices: \begin{pmatrix} → mat(delim: "(", ...)
+MathJax.TexConvertToTypstData('\\begin{pmatrix} a & b \\\\ c & d \\end{pmatrix}');
+// { typstmath: 'mat(delim: "(", \n  a, b;\n  c, d,\n)',
+//   typstmath_inline: 'mat(delim: "(", \n  a, b;\n  c, d,\n)' }
+
+// Cases: \begin{cases} → cases()
+MathJax.TexConvertToTypstData('\\begin{cases} x & \\text{if } x > 0 \\\\ -x & \\text{otherwise} \\end{cases}');
+// { typstmath: 'cases(\n  x & "if " x > 0,\n  - x & "otherwise",\n)',
+//   typstmath_inline: 'cases(\n  x & "if " x > 0,\n  - x & "otherwise",\n)' }
+
+// Delimiters: \lfloor..\rfloor → floor(), \|..\| → norm()
+MathJax.TexConvertToTypstData('\\lfloor x/2 \\rfloor + \\lceil y \\rceil');
+// { typstmath: 'floor(x\\/ 2) + ceil(y)', typstmath_inline: 'floor(x\\/ 2) + ceil(y)' }
+
+// Blackboard bold: \mathbb{Z} → ZZ
+MathJax.TexConvertToTypstData('\\mathbb{Z}');
+// { typstmath: 'ZZ', typstmath_inline: 'ZZ' }
+
+// Custom operators: \operatorname*{} → op("", limits: #true)
+MathJax.TexConvertToTypstData('\\operatorname*{argmax}_{x} f(x)');
+// { typstmath: 'op("argmax", limits: #true)_x f(x)',
+//   typstmath_inline: 'op("argmax", limits: #true)_x f(x)' }
+
+// Partial derivatives
+MathJax.TexConvertToTypstData('\\frac{\\partial f}{\\partial x}');
+// { typstmath: 'frac(partial f, partial x)', typstmath_inline: 'frac(partial f, partial x)' }
+
+// Text in math: \text{} → ""
+MathJax.TexConvertToTypstData('x \\text{ and } y');
+// { typstmath: 'x " and " y', typstmath_inline: 'x " and " y' }
+```
+
+The converter returns two representations — `typstmath` (block, may include Typst code-mode wrappers like `#math.equation()`, `#box()`) and `typstmath_inline` (pure math-mode, safe for inline `$...$` contexts). They differ for `\boxed`, `\tag`, and similar constructs:
+
+```js
+// \boxed — block wraps in #box(), inline is plain math:
+MathJax.TexConvertToTypstData('\\boxed{a+b}');
+// { typstmath:        '#align(center, box(stroke: 0.5pt, inset: 3pt, $a + b$))',
+//   typstmath_inline: 'a + b' }
+
+// Invalid LaTeX — empty typst, error message returned:
+MathJax.TexConvertToTypstData('\\frac{');
+// { typstmath: '', typstmath_inline: '', error: 'Missing close brace' }
+```
+
+When included via `outMath` options (`include_typst: true`), Typst output is also available through the rendering pipeline alongside MathML, AsciiMath, and other formats.
+
 ### Example of the include_sub_math option usage for tables containing nested tables and formulas
 
 #### parseMarkdownByHTML(html: string, include_sub_math: boolean = true)
@@ -431,6 +512,7 @@ const options = {
     outMath: {
         include_asciimath: true,
         include_mathml: true,
+        include_typst: true,
         include_latex: true,
         include_svg: true,
         include_tsv: true,
@@ -457,16 +539,22 @@ const parsed = MathpixMarkdownModel.parseMarkdownByHTML(html);
 
   { type: 'mathml', value: '<math xmlns="http://www.w3.org/1998/Math/MathML">\n  <msup>\n    <mi>x</mi>\n    <mn>1</mn>\n  </msup>\n</math>' },
   { type: 'asciimath', value: 'x^(1)' },
+  { type: 'typst', value: 'x^1' },
+  { type: 'typst_inline', value: 'x^1' },
   { type: 'latex', value: 'x^1' },
   { type: 'svg', value: '<svg >..</svg>' },
-    
+
   { type: 'mathml', value: '<math xmlns="http://www.w3.org/1998/Math/MathML">\n  <msup>\n    <mi>y</mi>\n    <mn>1</mn>\n  </msup>\n</math>' },
   { type: 'asciimath', value: 'y^(1)' },
+  { type: 'typst', value: 'y^1' },
+  { type: 'typst_inline', value: 'y^1' },
   { type: 'latex', value: 'y^1' },
   { type: 'svg', value: '<svg ></svg>' },
-      
+
   { type: 'mathml', value: '<math xmlns="http://www.w3.org/1998/Math/MathML">\n  <msup>\n    <mi>z</mi>\n    <mn>1</mn>\n  </msup>\n</math>' },
   { type: 'asciimath', value: 'z^(1)' },
+  { type: 'typst', value: 'z^1' },
+  { type: 'typst_inline', value: 'z^1' },
   { type: 'latex', value: 'z^1' },
   { type: 'svg', value: '<svg ></svg>' }
 ]
@@ -479,6 +567,7 @@ const options = {
     outMath: {
         include_asciimath: true,
         include_mathml: true,
+        include_typst: true,
         include_latex: true,
         include_svg: true,
         include_tsv: true,

doc/changelog.md

@@ -1,5 +1,24 @@
 # March 2026
 
+## [2.0.39] - Add Typst math format output
+
+- New Feature:
+  - LaTeX-to-Typst math conversion via `MathJax.TexConvertToTypstData(latex)`. Returns `{ typstmath, typstmath_inline, error? }`.
+  - `typstmath` — block representation (may include `#math.equation()`, `#box()`, `#align()` wrappers).
+  - `typstmath_inline` — pure math-mode output, safe for inline `$...$` contexts.
+  - `include_typst: true` option in `outMath` to include `<typstmath>` and `<typstmath_inline>` tags in rendered HTML.
+
+- Supported constructs:
+  - Fractions (`\frac` → `frac()`), roots (`\sqrt` → `sqrt()`, `\sqrt[n]` → `root()`), matrices (`pmatrix`/`bmatrix`/`vmatrix` → `mat()`), cases (`\begin{cases}` → `cases()`).
+  - Delimiter optimization: `\lfloor..\rfloor` → `floor()`, `\lceil..\rceil` → `ceil()`, `\|..\|` → `norm()`, `|..|` → `abs()`.
+  - Blackboard bold shorthands: `\mathbb{Z}` → `ZZ`, `\mathbb{N}` → `NN`, etc.
+  - Custom operators: `\operatorname*{argmax}` → `op("argmax", limits: #true)`.
+  - Text in math: `\text{...}` → `"..."`.
+  - Tags, labels, equation numbering, aligned environments, `\boxed`, accents, cancellations, colors, and 4200+ test cases.
+
+- Error Handling:
+  - `merror` nodes (invalid LaTeX) return `{ typstmath: '', typstmath_inline: '', error: '...' }` — errors never appear in Typst output.
+
 ## [2.0.38] - Fix infinite loop in `inlineMmdIcon` and `inlineDiagbox` silent mode
 
 - Bug Fix:

examples/mathpix-markdown-it-node-examples/conversion/math.js

@@ -20,6 +20,7 @@ const options = {
   outMath: {
     include_mathml: true,
     include_asciimath: true,
+    include_typst: true,
     include_latex: true,
     include_svg: true,
     include_tsv: true,

examples/mathpix-markdown-it-node-examples/conversion/tabular.js

@@ -20,6 +20,7 @@ const options = {
   outMath: {
     include_mathml: true,
     include_asciimath: true,
+    include_typst: true,
     include_latex: true,
     include_svg: true,
     include_tsv: true,

examples/mathpix-markdown-it-node-examples/conversion/tabular_include_sub_math.js

@@ -20,6 +20,7 @@ let options = {
   outMath: {
     include_asciimath: true,
     include_mathml: true,
+    include_typst: true,
     include_latex: true,
     include_svg: true,
     include_tsv: true,

examples/mathpix-markdown-it-node-examples/conversion/tabular_not_include_sub_math.js

@@ -20,6 +20,7 @@ const options = {
   outMath: {
     include_asciimath: true,
     include_mathml: true,
+    include_typst: true,
     include_latex: true,
     include_svg: true,
     include_tsv: true,

examples/react-app/use-parseMarkdownByHTML-method/config-overrides.js

@@ -0,0 +1,7 @@
+module.exports = function override(config) {
+  config.resolve.fallback = {
+    ...config.resolve.fallback,
+    path: require.resolve('path-browserify'),
+  };
+  return config;
+};

examples/react-app/use-parseMarkdownByHTML-method/package.json

@@ -11,10 +11,14 @@
     "react-dom": "^18.2.0",
     "react-scripts": "^5.0.1"
   },
+  "devDependencies": {
+    "path-browserify": "^1.0.1",
+    "react-app-rewired": "^2.2.1"
+  },
   "scripts": {
-    "start": "react-scripts start",
-    "build": "react-scripts build",
-    "test": "react-scripts test",
+    "start": "react-app-rewired start",
+    "build": "react-app-rewired build",
+    "test": "react-app-rewired test",
     "eject": "react-scripts eject"
   },
   "eslintConfig": {

examples/react-app/use-parseMarkdownByHTML-method/src/form.jsx

@@ -22,6 +22,7 @@ class ConvertForm extends React.Component {
       result: '',
       include_mathml: true,
       include_asciimath: true,
+      include_typst: true,
       include_latex: true,
       include_svg: true,
       include_tsv: true,
@@ -54,6 +55,7 @@ class ConvertForm extends React.Component {
       outMath: {
         include_mathml: this.state.include_mathml,
         include_asciimath: this.state.include_asciimath,
+        include_typst: this.state.include_typst,
         include_latex: this.state.include_latex,
         include_svg: this.state.include_svg,
         include_tsv: this.state.include_tsv,
@@ -91,6 +93,14 @@ class ConvertForm extends React.Component {
                   onChange={this.handleInputChange} />
                 asciimath
               </label>
+              <label>
+                <input
+                  name="include_typst"
+                  type="checkbox"
+                  checked={this.state.include_typst}
+                  onChange={this.handleInputChange} />
+                typst
+              </label>
               <label>
                 <input
                   name="include_latex"

lib/contex-menu/menu/consts.d.ts

@@ -18,6 +18,8 @@ export declare enum eMathType {
     mathmlword = "mathmlword",
     tsv = "tsv",
     csv = "csv",
+    typst = "typst",
+    typst_inline = "typst_inline",
     table_markdown = "table-markdown",
     smiles = "smiles"
 }