officetopdf-js

Convert DOCX, PPTX and XLSX to PDF from JavaScript — in Node.js, Bun, Deno and Electron.

No LibreOffice. No Chromium. No Docker.

Conversion is powered by office2pdf, a pure-Rust converter built on Typst. This package is the TypeScript distribution and API layer around it.

Install

bun add officetopdf-js

Only the binary for your platform is downloaded, via optional dependencies (the same pattern as esbuild and swc).

| Platform | Package | |----------|---------| | macOS Apple Silicon | officetopdf-darwin-arm64 | | macOS Intel | officetopdf-darwin-x64 | | Linux x64 (glibc) | officetopdf-linux-x64 | | Linux x64 (musl) | officetopdf-linux-x64-musl | | Linux ARM64 | officetopdf-linux-arm64 | | Windows x64 | officetopdf-windows-x64 |

Usage

import { convert } from "officetopdf-js";

const pdf = await convert(await Bun.file("report.docx").bytes(), { format: "docx" });

await Bun.write("report.pdf", pdf);

Input may be a Uint8Array, ArrayBuffer, or Blob/File. Output is always a Uint8Array.

Shortcuts

import { docxToPdf, pptxToPdf, xlsxToPdf } from "officetopdf-js";

const pdf = await docxToPdf(bytes);

Reusable converter

Fonts are parsed once per converter instead of once per conversion.

import { createConverter } from "officetopdf-js";

const converter = createConverter({
  fonts: [await Bun.file("fonts/Pretendard.ttf").bytes()],
  fontPaths: ["/usr/share/fonts"],
});

const pdf = await converter.convert(bytes, { format: "docx", pdfA: true });

await converter.dispose();

Options

ConvertOptions

| Option | Type | Description | |--------|------|-------------| | format | "docx" \| "pptx" \| "xlsx" | Input format. Inferred from File.name when omitted. | | paperSize | "a4" \| "letter" \| "legal" | Paper size override. | | landscape | boolean | Force landscape orientation. | | pdfA | boolean | Produce PDF/A-2b archival output. | | tagged | boolean | Tag document structure so screen readers can navigate it. | | pdfUa | boolean | Produce PDF/UA-1 accessible output; implies tagged. |

pdfUa enforces the full PDF/UA-1 standard and fails the conversion when the source cannot satisfy it — a document with no title raises ConversionFailedError: PDF/UA-1 error: missing document title. Use tagged when you want screen-reader structure without the strict compliance gate. | sheets | string[] | XLSX sheet filter; the only way to print a hidden sheet. | | slides | string | PPTX slide range, e.g. "1-5". | | signal | AbortSignal | Cancel an in-flight conversion. | | onWarning | (warning: ConversionWarning) => void | Non-fatal diagnostics, e.g. a missing font falling back. |

ConverterOptions

| Option | Type | Description | |--------|------|-------------| | fonts | (Uint8Array \| ArrayBuffer \| Blob)[] | TTF/OTF/TTC faces to register. | | fontPaths | string[] | Additional font directories. | | binaryPath | string | Use a specific office2pdf binary. | | timeoutMs | number | Conversion timeout, default 120000. |

Set OFFICE2PDF_BINARY to point every conversion at a binary of your choosing.

Warnings

A conversion can succeed while silently substituting a missing font. Opt in to hear about it:

const pdf = await convert(bytes, {
  format: "docx",
  onWarning: ({ kind, from, to, message }) => console.warn(kind, from, to, message),
});

Warnings carry the converter's own diagnostics, such as a font falling back to a substitute.

Errors

All failures are instances of OfficeToPdfError: ConversionFailedError (conversion or CLI failure, with upstream stderr in detail) and UnsupportedPlatformError (no binary for the current platform).

Notes

• A conversion spawns the office2pdf binary; concurrent calls are independent processes, so a reusable converter does not serialise them.
• Word's "Don't add space between paragraphs of the same style" (w:contextualSpacing) is currently ignored by the converter, so list-heavy DOCX files render with more vertical space than Word shows (upstream #1684).

Development

bun install
bun run ci:check

bun test runs the unit suite anywhere. The end-to-end suites under tests/ skip themselves unless their runtime is present, so nothing fails on a bare checkout.

Testing locally needs an office2pdf binary — point OFFICE2PDF_BINARY at one, or run bun run binaries:fetch.

bun run binaries:fetch stages the per-platform binary packages into npm/. It tracks the latest upstream release by default; set OFFICE2PDF_VERSION=v0.6.8 to pin one. It runs in CI on release.

License

Apache-2.0, matching the bundled office2pdf binaries, © their respective authors.