Historical snapshot last verified: 2026-09-14
The non-.NET implementations now live in PdfLibrarys. This snapshot is retained for reference; each repository owns its current capabilities and release process.
This document tracks implementation gaps between MiniPdf for .NET, Rust, Java, Go, Python, and Node.js. It is an engineering backlog, not a claim of complete Microsoft Office compatibility.
.NET is the current functional reference because it has the broadest renderer and compatibility coverage. It is not automatically the correct behavior: a shared security or conformance gap can exist in every implementation.
| Mark | Meaning |
|---|---|
I |
Implemented with source and test or benchmark evidence |
P |
Partially implemented or materially narrower than the .NET reference |
M |
Missing or currently ineffective |
B |
Node.js behavior inherited from the Rust engine |
? |
Evidence is insufficient; verify before changing the status |
| Capability | .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|---|
| XLSX to PDF | I | P | P | P | P | B |
| DOCX to PDF | I | P | P | P | P | B |
| PPTX to PDF | P | P | P | P | P | B |
| Path input and file output | I | I | I | I | I | B |
| In-memory input and PDF bytes | I | I | I | I | I | B |
| Stream input and output | I | M | M | I | M | M |
| Format detection API | Internal | I | I | I | I | B |
| Page-size override | DOCX only | I | I | I | I | B |
| Margin override | I | M | M | I | M | M |
| XLSX conversion controls | I | M | M | P | M | M |
| PDF compression option | I | M | M | I | M | M |
| Missing-font diagnostics | I | M | M | M | M | M |
| Effective custom font embedding | I | I | I | I | M | B |
| Native CLI | I | I | I | I | I | M |
| Tracked visual benchmark evidence | I | P | P | M | M | M |
| Bounded OOXML package loading | M | M | I | I | I | B/M |
Notes:
- Node.js is a native binding over the Rust engine. Rendering fixes normally
belong in
minipdf-rs; Node-specific work should focus on API exposure, asynchronous execution, packaging, and binding tests. - Python renders through the Rust engine via the
minipdf._nativePyO3 extension built by the package backend, falling back to the pure Python renderers only when the extension is not importable. The capability matrix below describes the pure Python fallback. - Node.js and Python pin their Rust engine by immutable Git revision. Releases are managed independently in their own repositories; the former cross-repository release dispatcher has been removed.
Pdoes not mean the same depth in every language. The detailed matrices below identify the important differences.- The public .NET page-size and margin overrides currently apply to DOCX. The other implementations expose a common page-size override for all formats.
The .NET reference exposes stream conversion, diagnostics, PDF compression,
DOCX margins, sheet selection, XLSX limits, orientation, fit-to-page controls,
print scale, rows-per-page, and culture-aware value formatting in
MiniPdf.cs.
| Gap relative to .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|
| Input/output stream API | M | M | I | M | M |
| Conversion diagnostics | M | M | M | M | M |
| PDF stream compression option | M | M | I | M | M |
| DOCX margin override | M | M | I | M | M |
| XLSX sheet selection | M | M | M | M | M |
| XLSX row/column limits | M | M | I | M | M |
| XLSX orientation/fit/scale controls | M | M | P | M | M |
| Culture-aware XLSX formatting | M | M | M | M | M |
| Font clear API | M | I | I | M | M |
| Registered-font list API | I | I | I | I | I |
| CLI font directory | I | I | I | M | M |
| CLI advanced XLSX options | M | M | P | M | M |
| Native CLI distribution | I | I | I | I | M |
| Non-blocking/async conversion API | M | M | M | M | M |
Evidence:
- Rust currently exposes only
page_sizeinConversionOptions. - Java currently exposes only
pageSizeinConversionOptions. - Go currently exposes page size, DOCX margins, PDF compression, XLSX row and
column limits, and XLSX orientation in
ConversionOptions. - Python currently exposes only
page_sizeinConversionOptions. - Node.js exposes synchronous Rust conversion bindings in
lib.rs; callers must use a worker thread to avoid blocking the Node.js event loop.
Go also provides bounded io.Reader input, io.Writer output, and complete
register/list/clear font lifecycle APIs. Conversion still builds the PDF bytes
in memory before writing them.
Before adding every .NET option to every language, define a versioned common options contract. Format-specific options should be capability-gated and should fail clearly when used with the wrong input format.
| Feature | .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|---|
| Paragraphs, runs, tabs, line breaks | I | I | P | P | I | B |
| Bold, italic, size, color, underline | I | P | M | M | P | B |
| Paragraph spacing and alignment | I | P | M | M | P | B |
| Explicit page breaks | I | I | P | I | I | B |
| Section page size and margins | I | I | P | I | I | B |
| Tables and cell borders | I | P | M | M | M | B |
| Merged table cells | I | P | M | M | M | B |
| Lists and numbering | I | P | M | M | M | B |
| Headers and footers | I | M | M | M | M | B/M |
| Footnotes/endnotes | I | M | M | M | M | B/M |
| Columns | I | M | M | M | M | B/M |
| Images and VML drawings | I | P | M | M | M | B |
| Floating/anchored objects | P | P | M | M | M | B |
| TOC and field-result layout | P | M | M | M | M | B/M |
| CJK and RTL shaping/fallback | I | P | M | M | M | B |
Primary implementation evidence:
- .NET:
DocxReader.csandDocxToPdfConverter.cs - Rust:
docx.rs - Java:
DocxConverter.java - Go:
docx.go - Python:
docx.py
.NET paragraph shading uses the paragraph line box rather than the text baseline, extends through spacing between consecutive borderless shaded paragraphs with matching indents, and includes Word's 1.5pt horizontal padding. Shading stops at unshaded paragraphs and explicit page or section breaks. Horizontal paragraph borders preserve double rules. Tables in Word compatibility modes up to 14 align implicit left indents with first-cell content; modern implicit indents continue to align the table border. Inline images in table cells honor the paragraph's left, center, or right alignment in both body and header/footer tables. Cambria table cells use the same preferred-font advances for wrapping and row-height calculation, including header/footer tables. Auto-spaced body paragraphs do not carry the next text-line ascent into a following table. Large first-paragraph runs advance subsequent content from their rendered baseline rather than the smaller inherited paragraph-mark baseline. Cell line height distinguishes explicit paragraph-mark sizing from inherited defaults. Collapsed table borders contribute half their stroke widths to natural row heights and text insets; center/bottom alignment uses the remaining content area. Cambria/Calibri paragraph flow tracks font ascents across text, empty marks, and inline-image hosts. Auto-spaced image-only paragraphs add proportional font leading without scaling image height. Hard section starts collapse paragraph space-before against the closing section's space-after. Image-only paragraphs reclaim the next text ascent before body tables, while border-only empty marks reset text-ascent tracking. Courier transitions use Courier font metrics. Symbol cells account for the Segoe fallback's ascent and line height when the PDF writer selects that font. Mixed-format Cambria paragraphs measure each run's bold/italic font advances and spaces consistently for wrapping, run positioning, alignment, and run shading.
| Feature | .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|---|
| Shared/inline strings and scalar values | I | I | I | I | I | B |
| Number/date format rendering | I | P | P | P | M | B |
| Formula cached values | I | P | P | M | M | B |
| Fonts, fills, borders, alignment | I | P | P | P | M | B |
| Row heights and column widths | I | I | P | P | M | B |
| Merged cells | I | I | I | M | M | B |
| Hidden rows, columns, and sheets | I | P | P | P | M | B |
| Print area and print titles | I | P | P | P | M | B |
| Paper size, margins, orientation | I | P | P | P | M | B |
| Fit-to-page and print scale | I | P | P | P | M | B |
| Conditional and table styles | P | P | P | P | M | B |
| Raster images | I | P | P | P | M | B |
| VML/vector drawings | I | P | P | M | M | B |
| Charts | P | M | M | M | M | B/M |
Primary implementation evidence:
- .NET:
ExcelReader.csandExcelToPdfConverter.cs - Rust:
xlsx.rs - Java:
PoiXlsxRenderer.java - Go:
xlsx.goandxlsx_print.go; explicit print areas select grid rendering with repeated titles, hidden cells, scaling, and page breaks. - Python:
xlsx.py
.NET resolves unnamed XLSX font families from the workbook's minor theme font, falling back to the first style font when no theme font is available. Explicit font families and each style's size and weight are preserved. .NET XLSX double cell borders render as two solid strokes with a clear gap, including print scaling and merged-cell continuations across pages. Adjacent single borders do not fill the gap on a shared double edge. Border conflict resolution is buffered per page to preserve low-memory conversion behavior. Automatic Calibri 11 row defaults use Excel's print line height; custom sheet defaults and explicitly sized rows preserve their authored heights. Calibri column widths use font-specific maximum-digit print metrics rather than the generic font calibration. Unsupported scripts retain Unicode font fallback instead of being forced into the Normal style's Calibri font. For charts anchored outside data columns, overflowing larger-font headings use spreadsheet default widths when widths are not explicit. Other chart sheets retain their existing content sizing.
Java XLSX support is substantially broader than Java DOCX/PPTX support because it uses Apache POI and PDFBox. It should not be described as uniformly "text-only" across every Office format.
PPTX support remains partial in every implementation, including .NET.
| Feature | .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|---|
| Slide dimensions and one page per slide | I | I | I | I | I | B |
| Theme and placeholder text | I | P | M | M | M | B |
| Text style and paragraph layout | P | P | M | M | M | B |
| Basic shapes and connectors | P | P | M | M | M | B |
| Shape transforms and geometry | P | P | M | M | M | B |
| Raster images | I | P | M | M | M | B |
| SVG images | P | P | M | M | M | B |
| Tables | P | P | M | M | M | B |
| SmartArt fallback | P | P | M | M | M | B |
| Charts | M | M | M | M | M | M |
| Animations, transitions, media | M | M | M | M | M | M |
Primary implementation evidence:
- .NET:
PptxReader.csandPptxToPdfConverter.cs - Rust:
pptx.rs - Java:
PptxConverter.java - Go:
pptx.go - Python:
pptx.py
| Area | .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|---|
| Registered and system font fallback | I | I | P | P | M | B |
| Font embedding and subsetting | I | P | P | P | M | B |
| ToUnicode/CID output | I | P | P | I | M | B |
| JPEG/PNG with transparency | I | P | P for XLSX | M | M | B |
| SVG rendering | P | P for PPTX | M | M | M | B |
| EMF/WMF handling | P | P | P for XLSX | M | M | B |
| Public low-level PDF construction API | M | P | P | P | M | M |
The low-level PDF API is inconsistent: Rust, Java, and Go expose writer types, while .NET keeps comparable types internal and Node.js does not bind Rust's writer. Decide whether PDF construction is a supported product API before attempting parity. If it is not, make implementation-specific writer types internal in the next breaking release.
Java, Go, and Python now enforce explicit package-loading limits.
Java rejects excessive entry counts, oversized or highly compressed entries,
unsafe paths, duplicate entries, and XML external entities in
OoxmlPackage.java
and
SecureXml.java.
Python applies package limits and path checks in
office.py.
Go applies entry count, entry and total size, expansion ratio, encryption,
duplicate path, and unsafe path checks in
office.go, exposed through ErrInvalidPackage.
.NET, Rust, and therefore Node.js still need the same bounded OOXML package contract. Cross-language conformance fixtures must cover:
- maximum entry count, per-entry size, and total uncompressed size;
- maximum compression ratio and encrypted-entry rejection;
- duplicate normalized path rejection;
- absolute path, drive prefix, and
..traversal rejection; - external relationship and XML DTD/entity blocking;
- consistent error categories and malformed-package tests.
Security behavior should converge before rendering APIs are expanded.
All six implementations have language-specific visual benchmark runners under
scripts, but tracked result coverage is incomplete.
| Evidence | .NET | Rust | Java | Go | Python | Node.js |
|---|---|---|---|---|---|---|
| Unit tests for public API | I | I | I | P | P | P |
| Malformed/security fixtures | P | P | I | P | I | B/P |
| Classic XLSX report | I | I | M | M | M | M |
| Classic DOCX report | I | I | M | M | M | M |
| Issue XLSX report | I | I | I | I | M | M |
| Issue DOCX report | I | M | I | M | M | M |
| Issue PPTX report | I | M | M | M | M | M |
| Classic PPTX corpus/report | M | M | M | M | M | M |
A feature should not move from P to I based only on a parser or API being
present. Require a focused unit test plus a reproducible visual benchmark case.
- 2026-09-15: the complete Java issue DOCX benchmark covers all 28 tracked
fixtures with successful conversions and both Microsoft 365 and LibreOffice
references. Explicit page breaks, hard line breaks, printable tab spacing,
next-page section breaks, and landscape page sizing raised the average from
0.5683to0.6398.TestIssue61reached8/8pages,issues66reached3/3pages,CCU_articlereached21/21pages, andTemplate for MSc Thesisreached17/17pages. See the trackedreport.
- 2026-09-14: a five-case classic XLSX baseline scored
0.8093and reported a one-byte page content-stream length error in every candidate PDF. After the writer fix, the same five cases retained0.8093with no PDF structure errors. See the localbeforeandafterreports. - 2026-09-14: removing synthetic
Sheet Ntext while preserving worksheet vertical spacing raised the same five-case average from0.8093to0.9365. The empty-workbook case improved from0.5995to1.0, and no case regressed. See the localreport. - 2026-09-14: nine-column horizontal pagination raised the wide-table case from
0.6867with1/3pages to0.9953with3/3pages. The five-case average reached0.9975; an apparentclassic02text-score fluctuation was confirmed unrelated because its before/after candidate SHA-256 hashes were identical. See the localreport. - 2026-09-14: parsing native DOCX
w:pgMarvalues and adding validated margin overrides raised the five-case classic DOCX average from0.9872to0.9889; all cases improved or held. See the localreport. - 2026-09-14: horizontally paginating overflowing single-column XLSX text
raised
classic09_long_textfrom0.1840with1/12pages to0.8942with12/12pages. The complete 191-case classic XLSX average increased from0.8436to0.8473, with all unrelated case scores unchanged. See the localreport. - 2026-09-14: preserving explicit XLSX row and cell references raised
classic11_sparse_rowsfrom0.6990to0.9996andclassic12_sparse_columnsfrom0.6993to0.9995, with both candidates reaching2/2reference pages. The complete 191-case average increased from0.8473to0.8503, with no case regression. - 2026-09-14: skipping worksheets with no physical rows while retaining a
fallback page for an entirely empty workbook raised
classic30_mixed_empty_and_filled_sheetsfrom0.6834with4/2pages to0.9993with2/2pages. The complete average reached0.8519; SHA-256 comparison against the preceding stage showed this was the only changed candidate among all 191 cases. - 2026-09-14: mapping OOXML boolean cells from
1and0to Excel-compatibleTRUEandFALSEraisedclassic42_boolean_valuesfrom0.9264to0.9869. The complete average reached0.8522; SHA-256 comparison against the preceding stage showed this was the only changed candidate among all 191 cases. - 2026-09-14: the complete Go issue XLSX benchmark covers all 24 tracked issue
fixtures with 24 successful conversions and no missing Microsoft 365 or
LibreOffice references. The report averages
0.4929and compares up to three pages per case because two stress fixtures produce 3,781 and 2,860 candidate pages. See the trackedreport.
- Define one bounded OOXML package-loading contract and shared malicious fixtures.
- Implement the contract in .NET and Rust; Node.js inherits Rust.
- Implement bounded OOXML package loading and
ErrInvalidPackagein Go. - Verify Java and Python against the same fixtures and align error behavior.
- Fix status documentation drift:
ROADMAP.mdstill says Rust PPTX is unsupported and omits Java, Go, Python, and Node.js. - Fix
README.md, which lists Python input as DOCX only even though the Python dispatcher supports XLSX and PPTX. - Align the Python package and runtime version declarations in
pyproject.tomland__init__.py.
- Publish complete current benchmark reports for every language across classic XLSX/DOCX and issue XLSX/DOCX/PPTX.
- Add a shared classic PPTX corpus and report path.
- Rust: close advanced DOCX gaps, especially headers/footers, lists, columns, notes, and floating objects.
- Rust: add XLSX chart rendering or explicitly declare charts out of scope.
- Java: add DOCX tables/styles/images, then PPTX styles/shapes/images.
- Go: add effective registered TTF embedding with Type0/CID and ToUnicode.
- Go: add TTF subsetting, TTC support, system fallback, and complex-script shaping.
- Go: add XLSX styles/merges/images, DOCX tables/images, and PPTX shapes/images.
- Python: add effective font embedding and Unicode shaping before complex layout.
- Python: add DOCX tables/images, XLSX styles/merges/images, and PPTX shapes/images.
- .NET and Rust: define and test the intended PPTX compatibility boundary, including explicit non-goals for animation and media.
- Define a versioned common conversion-options contract and shared option validation fixtures.
- Standardize format detection and error categories.
- Standardize register/list/clear font lifecycle APIs.
- Decide whether stream conversion is required in each language or whether bytes/file APIs are the portable contract.
- Decide whether low-level PDF writer types are public supported APIs.
- Add a non-blocking Node.js conversion API or an official worker-thread helper.
- Decide whether Node.js requires a CLI; do not duplicate the Rust CLI without a Node-specific distribution need.
- Add release gates that run unit tests and the relevant focused visual benchmark before publishing each package.
A capability is aligned only when all of the following are true:
- The public behavior and unsupported cases are documented.
- Shared valid, malformed, and boundary fixtures pass in every applicable implementation.
- Each implementation has a focused unit test for its native API.
- Visual output is checked against the same Microsoft 365 reference and LibreOffice auxiliary reference.
- Page count, text similarity, visual score, and known deviations are recorded.
- The package release workflow executes the required tests.
When updating this matrix, link the source, test, benchmark report, and issue or pull request that justify each status change.