# PDF Oxide — The Fastest PDF Library for Python and Rust

> The fastest PDF library for Python and Rust.
> Text extraction, image extraction, PDF creation, editing, and markdown conversion.
> Mean 0.8ms per document. 100% pass rate on 3,830 real-world PDFs.
> 5× faster than PyMuPDF, 15× faster than pypdf.
> MIT / Apache-2.0 license. Current version: 0.3.34.

- Python: `pip install pdf-oxide`
- Rust: `cargo add pdf_oxide`
- Full documentation: https://pdf.oxide.fyi
- Full documentation in one file: https://pdf.oxide.fyi/llms-full.txt
- Source code: https://github.com/yfedoseev/pdf_oxide

## Documentation

- [Python Quick Start](https://pdf.oxide.fyi/docs/getting-started/python): Install with pip, extract text, create PDFs, edit documents
- [Rust Quick Start](https://pdf.oxide.fyi/docs/getting-started/rust): Add to Cargo.toml, PdfDocument and Pdf APIs, error handling
- [Full Docs Site](https://pdf.oxide.fyi): Complete documentation with 38 pages

## Key Features

### Extraction
- extract_text, extract_spans, extract_chars: Text with position, font, size metadata
- extract_images: Content streams, Form XObjects, inline images
- to_markdown, to_html: Document conversion with structure preservation
- Page rendering to PNG/JPEG images (Rust, tiny-skia engine)
- Built-in OCR via PaddleOCR + ONNX Runtime (no Tesseract)
- FormField extraction, annotations, bookmarks, metadata, XMP, text search

### Creation
- Pdf::from_markdown, from_html, from_image, from_images: Create from various sources
- OfficeConverter: Convert DOCX, XLSX, PPTX to PDF without Microsoft Office
- Pdf::from_qrcode, from_barcode: QR codes and barcodes (Code128, EAN-13, UPC-A)
- PdfBuilder: Fluent API for title, author, page size, margins, fonts, text, images
- DocumentBuilder: Low-level API for pages, text positioning, form fields, annotations, tables

### Editing
- DocumentEditor: Open existing PDFs, DOM-style text find/replace
- Page operations: rotate, crop, merge, extract pages
- Form editing: get/set values, add/remove fields, flatten
- Annotation editing, image manipulation, redaction
- Encryption: AES-256, password protection

### Compliance
- PDF/A validation and conversion
- PDF/UA accessibility checks
- PDF/X print production validation

## Performance

- Mean: 0.8ms per document on 3,830 real-world PDFs
- 100% pass rate, zero panics, zero slow documents
- 5× faster than PyMuPDF, 15× faster than pypdf
- Pure Rust core, Python bindings via PyO3

## Links

- GitHub: https://github.com/yfedoseev/pdf_oxide
- PyPI: https://pypi.org/project/pdf-oxide/
- crates.io: https://crates.io/crates/pdf_oxide
- docs.rs: https://docs.rs/pdf_oxide
- Documentation: https://pdf.oxide.fyi