@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:

Scenario	@office-open/docx	docx	Speedup
Simple document (2 paragraphs)	25.7K ops/s	5.3K ops/s	4.84x
Styled paragraphs (20 paragraphs)	24.2K ops/s	4.4K ops/s	5.45x
Table (10x5 cells)	15.5K ops/s	3.3K ops/s	4.70x
Full featured (header/footer/headings/table/paragraphs)	13.8K ops/s	2.6K ops/s	5.30x

License

• MIT © Demo Macro