![](\"https://raw.githubusercontent.com/mayank1513/mayank1513/main/popper.png\")
\n\n[](https://github.com/md2docx/math/actions/workflows/test.yml) [](https://codecov.io/gh/md2docx/math) [](https://www.npmjs.com/package/@m2d/math)  \n\n> A plugin that transforms LaTeX-style math (inline and block) into DOCX-compatible equations using docx.\n\n> This package expects that the math nodes have already been extracted using `remark-math` plugin.\n\n---\n\n## 📦 Installation\n\n```bash\nnpm install @m2d/math\n```\n\n```bash\npnpm add @m2d/math\n```\n\n```bash\nyarn add @m2d/math\n```\n\n---\n\n## 🚀 Overview\n\nThe `@m2d/math` plugin for [`mdast2docx`](https://github.com/mayankchaudhari/mdast2docx) enables support for **LaTeX math rendering** in DOCX exports. It parses inline and block-level math expressions written in LaTeX syntax and converts them into proper Word-compatible Math elements using the `docx` library.\n\n> Supports superscripts, subscripts, fractions, radicals, summations, symbols, and more.\n\n---\n\n## ✨ Features\n\n- Parses LaTeX-style math expressions\n- Converts math to `docx.MathRun`, `docx.MathFraction`, `docx.MathRadical`, etc.\n- Supports inline and block math (`$...$`, `$$...$$`)\n- Supports standard math macros like `\\frac`, `\\sqrt`, `\\sum`, `\\alpha`, and many others\n- Handles superscripts (`^`) and subscripts (`_`) intelligently\n- Gracefully ignores unsupported macros like `\\left`, `\\right`, etc.\n\n---\n\n## 🛠️ Usage\n\n```ts\nimport { toDocx } from \"@m2d/core\";\nimport { mathPlugin } from \"@m2d/math\";\n\nconst plugins = [mathPlugin()];\n\nconst buffer = await toDocx(mdastTree, {\n plugins,\n});\n```\n\n---\n\n## 🧪 Example\n\n### Input Markdown (via MDAST)\n\n```md\nThis is inline math: $E = mc^2$\n\n$$\n\\frac{a^2 + b^2}{c^2} = 1\n$$\n```\n\n### Output DOCX\n\n- Inline math (`$E = mc^2$`) → `E = mc²` as a Word MathRun.\n- Block math renders as full equation paragraphs.\n\n---\n\n## ⚙️ Internals\n\n- Uses [`latex-math`](https://www.npmjs.com/package/latex-math) to parse LaTeX math AST.\n- Converts LaTeX nodes to `docx.MathRun[]` elements.\n- Supports common math macros with fallback to Unicode symbols via an internal symbol map.\n- Integrates seamlessly with `@m2d/core`.\n\n---\n\n## 🧩 Supported Macros\n\nIncludes (but not limited to):\n\n```\n\\frac, \\sqrt, \\sum, \\int, \\alpha, \\beta, \\theta, \\leq, \\geq, \\neq, \\infty, \\cdot\n```\n\n---\n\n## **⚠️ Limitations**\n\n- Does not support full LaTeX environments (`\\begin{align}`, etc.)\n- Complex expressions may need pre-processing\n- Does not render styled math (`\\textcolor`, etc.)\n\n---\n\n## ⭐ Support Us\n\nIf you find this useful:\n\n- ⭐ Star [mdast2docx](https://github.com/tiny-md/mdast2docx) on GitHub\n- ❤️ Consider [sponsoring](https://github.com/sponsors/mayank1513)\n\n---\n\n## 🧾 License\n\nMIT © [Mayank Chaudhari](https://github.com/mayankchaudhari)\n\n---\n\nMade with 💖 by Mayank Kumar Chaudhari
\n","readmeFilename":"README.md"}