@office-open/docx

@office-open/docx

Easily generate .docx files with JS/TS with a nice declarative API. Works for Node and on the Browser.

Features

• 📄 Document Generation — Create Word documents with sections, headers, footers, and page numbers
• ✍️ Paragraphs & Text — Rich text support with bold, italic, underline, strikethrough, and more
• 📊 Tables — Full table support with merged cells, borders, and styles
• 🖼️ Images — Inline and floating images with sizing, positioning, and wrapping
• 🔗 Hyperlinks — External and internal hyperlinks with custom styling
• 📑 Headers & Footers — First, last, even/odd page headers and footers
• 📋 Lists — Numbered and bulleted lists with multiple levels and custom formats
• 🎨 Styles — Paragraph, character, and table styles with inheritance
• 📖 Table of Contents — Auto-generated table of contents with custom styling
• 📝 Footnotes & Endnotes — Comprehensive footnote and endnote support
• 📈 Charts — Bar, line, pie, area, and scatter charts with customization
• 🔢 Math Equations — Full mathematical equation support via MathML
• 🧩 SmartArt — Built-in SmartArt graphic generation
• 📚 Bibliography — Source management and citation support
• 💬 Comments — Document comments with author and date tracking
• 📝 Track Revisions — Insertions, deletions, and formatting changes
• 📋 Content Controls — Structured document tags (SDT) for form-like documents
• 📦 Text Boxes — Floating text boxes with content and styling
• ☑️ Checkboxes — Form checkbox support in documents
• 🖌️ DrawingML — Shapes with fills, shadows, effects, and transformations
• 🔤 Custom Fonts — Font embedding and custom font tables
• 🔧 Template Patching — Patch existing DOCX templates via placeholder replacement
• ⚙️ Settings — Comprehensive document settings and compatibility options

Installation

# Install with npm
$ npm install @office-open/docx

# Install with pnpm
$ pnpm add @office-open/docx

Quick Start

import { Document, Paragraph, TextRun, Packer } from "@office-open/docx";
import { writeFileSync } from "node:fs";

const doc = new Document({
  sections: [
    {
      children: [
        new Paragraph({
          children: [
            new TextRun("Hello World"),
            new TextRun({
              text: " - Bold text",
              bold: true,
            }),
          ],
        }),
      ],
    },
  ],
});

const buffer = await Packer.toBuffer(doc);
writeFileSync("My Document.docx", buffer);

Examples

Check the demo folder for 100+ working examples covering every feature.

Benchmark

Performance comparison against original docx (9.6.1) package (higher ops/s is better, Windows 11 / Node 24).

DEFLATE = compressed (default), STORE = no compression. Both libraries use DEFLATE.

Create + toBuffer (end-to-end)

Scenario	DEFLATE sync	STORE sync	DEFLATE async	STORE async	docx
Simple (2 paragraphs)	395 ops/s	3,024 ops/s	414 ops/s	3,078 ops/s	201 ops/s
Styled paragraphs (20)	597 ops/s	2,315 ops/s	604 ops/s	2,453 ops/s	247 ops/s
Table (10×5)	460 ops/s	1,984 ops/s	597 ops/s	1,961 ops/s	212 ops/s
Full featured (header/footer/headings/table/paragraphs)	381 ops/s	1,294 ops/s	418 ops/s	1,324 ops/s	193 ops/s

Large Files — Create + toBuffer

Scenario	DEFLATE sync	STORE sync	DEFLATE async	STORE async	docx
2000 paragraphs	49.0 ops/s	67.4 ops/s	20.8 ops/s	66.6 ops/s	26.2 ops/s
200×10 table	90.1 ops/s	129.1 ops/s	25.5 ops/s	125.5 ops/s	37.0 ops/s
20 sections × 100 paragraphs	47.4 ops/s	83.4 ops/s	23.3 ops/s	85.7 ops/s	28.0 ops/s

Large File (~100MB) — Mixed Content

2000 paragraphs + 200 unique images (500KB each) + 100×10 table. Speedup is vs docx.

Method	Speed	Speedup
DEFLATE sync	0.35 ops/s	1.2x
STORE sync	0.36 ops/s	1.2x
DEFLATE async	0.40 ops/s	1.3x
STORE async	0.39 ops/s	1.3x
docx	0.30 ops/s

License

• MIT © Demo Macro