Skip to content

v0.1.0 - Initial release

Choose a tag to compare

@DrBaher DrBaher released this 04 May 18:36
· 38 commits to main since this release

Initial release of docx2pdf-cli — an honest, batch-aware DOCX → PDF CLI with hybrid backends (LibreOffice, Gotenberg, ConvertAPI, Apple Pages, Microsoft Word, textutil-cups).

Highlights

  • Backend transparency — --why prints the full decision tree (which backend was selected, why the others were skipped). --strict-fidelity refuses to silently fall back to the text-only backend.
  • Concurrency-safe LibreOffice — each call gets its own -env:UserInstallation profile dir, so --concurrency N runs parallel conversions without the deadlocks that plague other LibreOffice wrappers.
  • Batch mode — multiple inputs with --out-dir, NDJSON output via --json for CI piping, continue-on-error per file, deterministic ordering.
  • Font preflight — --check-fonts reports which fonts in the document aren't installed; an automatic stderr warning fires before LibreOffice/Gotenberg substitute silently.
  • Internal glob expansion for Windows and quoted patterns, so docx2pdf "*.docx" --out-dir ./pdfs works cross-shell.

Install

npm i -g docx2pdf-cli

You'll also need at least one backend's runtime (LibreOffice is the easiest). Run docx2pdf --doctor to see what's available on your machine.

Tests

85 tests across unit and subprocess suites. Run npm test.