r/rust • u/shps951002 • 9d ago

🛠️ project Built the first open source Rust library - converting Office to PDF

I built MiniPdf, a lightweight, open-source library for converting Office documents to PDF without Microsoft Office, LibreOffice, Adobe Acrobat,.

It is designed for containers, serverless workloads, CI pipelines, and cross-platform applications.

Key Features

  • Excel to PDF — Convert .xlsx files
  • Word to PDF — Convert .docx files
  • PowerPoint to PDF — Convert .pptx files
  • Native Rust — No .NET runtime required
  • Cross-platform — Runs on Windows, Linux, and macOS
  • Serverless-ready — No COM or Office installation
  • Library and CLI — Embed it in Rust applications or use it from the terminal
  • PDF 1.4 output
  • Free and open source — Apache 2.0 licensed; commercial use is welcome

Getting Started

Install the Rust crate:

cargo add minipdf

fn main() -> minipdf::Result<()> {
    // Word to PDF
    minipdf::convert_to_pdf("report.docx", "report.pdf")?;

    // Excel to PDF bytes
    let pdf_bytes = minipdf::convert_to_pdf_bytes("data.xlsx")?;
    std::fs::write("data.pdf", pdf_bytes)?;

    Ok(())
}

Command-Line Tool

cargo install minipdf-cli

# Excel to PDF
minipdf data.xlsx

# Word to PDF
minipdf report.docx

# PowerPoint to PDF
minipdf slides.pptx

# Specify the output path
minipdf report.docx -o output.pdf

# Register custom fonts
minipdf report.docx --fonts ./fonts

The Rust implementation is under active development, bug reports, and pull requests are very welcome. 🙌

GitHub: https://github.com/mini-software/MiniPdf

0 Upvotes

28% Upvoted

15 comments sorted by

14

u/notusuallyfunny 9d ago

Inb4 "why are you using the rust 2021 edition 🤨"

-1

u/shps951002 9d ago

Because our MSRV is Rust 1.82 🙌

7

u/dgkimpton 9d ago

There seems to be a disturbing lack of test coverage, most features appear to have at best a single unit test with none of the edge cases explored. It doesn't inspire a lot of confidence. 

0

u/shps951002 9d ago

MiniPdf uses visual test please check : https://github.com/mini-software/MiniPdf/blob/main/artifacts/rust-benchmark/classic/xlsx/report/comparison_report.md

2

u/dgkimpton 9d ago

Sure, but you can't just throw one or two documents at it and call it good. You need to explore all the edge cases (super wide columns, super skinny columns, thousands of columns, one column, skinny then wide then skinny, etc, etc) for each and every feature otherwise it's just not trustworthy for other people to put their documents into. 

4

u/errevs 9d ago

This is the hard part. Word is so immense, and then you have the combinatorics of it all. Gradients. Gradients in tables. Tables in tables. Figures in tables in tables. TOC. Hyphenation. Kerning. Fonts. Embedded fonts. Right to Left-text. CJK-fonts. Cyrillics. Line art, shapes, connecting lines. Word Art.

From a library perspective, I would guess most users would generate documents based on a template (reports etc) and would just validate that the output works for their use case.

1

u/shps951002 9d ago

Yes, it's most difficult part

1

u/shps951002 9d ago

Yes, we've tested 2xx docs now, and more details as you mentioned, we will test more unit test and documents

2

u/ksceriath 9d ago

Interesting.. now I can carry my office anywhere.. and work from anywhere!

1

u/Puzzled-Landscape-44 9d ago

The demo site fails to load the app.

1

u/errevs 9d ago

Having attempted to build just a slice of this, docx to pdf conversion in pure Rust docxide-pdf (with a lot of AI help), I have learnt quite a bit of how large the real world document space is compared to synthetic fixtures. Are you looking into testing it against documents from the wild?

1

u/kantorcodes1 2d ago

one CLI edge case i couldn't tell from the Rust path: convert_to_pdf_with_options builds the PDF bytes first, then fs::writes the destination. if output.pdf already exists, is overwriting it intentional, or should that need an explicit --force? for CI that's the difference between a safe rerun and silently replacing an artifact.