@m2d/md2docx

The simplest way to convert Markdown → DOCX (Word). Batteries-included wrapper around all @m2d/* plugins and Unified — just one import, one call.

✅ Supports GFM, HTML, tables, images, emoji, math (LaTeX), Mermaid diagrams, frontmatter, and more. ✅ Works in Node.js & browser environments (auto-skips unsupported plugins on server). ✅ Built on top of @m2d/core → produces real .docx files using docx.

🚀 Installation

# with pnpm
pnpm add @m2d/md2docx

# or npm
npm install @m2d/md2docx

# or yarn
yarn add @m2d/md2docx

✨ Quick Start

import { md2docx } from "@m2d/md2docx";
import { writeFileSync } from "node:fs";

const markdown = `
# Hello World 👋

- Supports **Markdown**
- Tables, math ($E = mc^2$), images, and more
`;

const docxBlob = await md2docx(markdown); // default outputType = 'blob'

// In Node: save to file
writeFileSync("output.docx", Buffer.from(await docxBlob.arrayBuffer()));

📦 API

md2docx(
  md: string,
  docxProps?: IDocxProps,
  defaultSectionProps?: ISectionProps,
  outputType?: OutputType, // "blob" | "buffer" | "base64" | "stream"
  pluginProps?: {
    mermaid?: MermaidOptions;
    list?: ListOptions;
    table?: TableOptions;
    emoji?: EmojiOptions;
    image?: ImageOptions;
  }
): Promise<OutputTypeResult>;

🧠 What’s Included (Under the Hood)

👉 On Node/server-side, HTML & image plugins are skipped automatically to avoid DOM/canvas issues.

🛠 Example – Custom Options

import { md2docx } from "@m2d/md2docx";

await md2docx(
  markdown,
  { title: "My Doc", author: "Mayank" }, // docxProps
  undefined, // keep default section props
  "buffer", // outputType
  {
    image: { maxWidth: 500 },
    mermaid: { theme: "dark" },
  }
);

⚠️ Notes & Best Practices

• When using HTML (<div>, <span>, etc.), sanitize input if it's user-generated.
• For full control or custom Node pipelines, use lower-level packages like @m2d/core.
• Mermaid & image rendering may require browser/polyfill contexts.

📚 Related Packages

🤝 Contributing

Pull requests and issue reports welcome! If your team uses this in production, please consider starring the repo or posting feedback.

📜 License

MPL-2.0 © Mayank Chaudhari and contributors

Made with 💖 by Mayank Kumar Chaudhari