Documents in. Possibilities out.
DocVortex is a standalone Python engine for parsing and converting documents. It reads native text and document structure into a unified representation, then exports the result in the formats your workflow needs.
- Multi-format input — read text PDFs, Office files, OpenDocument files, EPUB, HTML, OFD, CSV and TSV.
- Parse once, export many times — reuse the same result for Markdown, HTML, LaTeX, DOCX, EPUB, PDF and structured JSON.
- Portable results — save document structure and image assets in a Bundle, then export again without the source file.
- Composable APIs — use the complete pipeline or integrate analysis, postprocessing and rendering separately.
Native parsing works without an OCR or VLM inference service. Use DocVortex directly through its CLI or Python SDK.
PDF performance
Release 0.5.10 uses Rust acceleration: public parsing is 2.93× as fast as 0.4.25 on the tested corpus.
| Pipeline | 0.4.25 python | 0.5.10 rust | Speedup | Time reduction | Peak RSS reduction |
|---|---|---|---|---|---|
DocVortex public parse() |
42.36 s | 14.48 s | 2.93× | 65.82% | 31.17% |
| MinerU Flash | 44.50 s | 14.44 s | 3.08× | 67.55% | 29.84% |
| MinerU shared PDF processing | 76.28 s | 12.85 s | 5.94× | 83.16% | 35.65% |
Same-machine warm-run comparison on 32 PDFs / 299 pages (31 PDFs for Flash). The existing 0.4.25 measurements are reused. For 0.5.10, each document is warmed once and timed five times in each of three balanced rounds; times sum the medians of the three per-document medians. RSS reductions are medians of per-document process-tree peak RSS reductions. MinerU results include improvements in both projects. The shared pipeline excludes model computation; excluding the extreme dense-table sample, its speedup is 2.87×.
Quick start
Requires Python 3.10–3.14.
Install
pip install docvortex
Command line
Convert a text PDF to Markdown:
docvortex convert report.pdf --format markdown --output output/report.md
Replace report.pdf with a local file in any supported input format.
Use --format to choose the output; run docvortex convert --help for options.
The root-level --log-level option controls loguru output and defaults to info.
It must precede the command; DOCVORTEX_LOG_LEVEL=warning can also configure it.
Python
Parse a document once and export it twice:
import docvortex
result = docvortex.parse("report.pdf")
result.export("output/report.md", output_format="markdown")
result.export("output/report.docx", output_format="docx")
The result owns its document structure and assets, so further exports do not
reopen or reparse the source. Existing output files are protected by default;
use overwrite=True in Python or --overwrite in the CLI to replace them.
Supported formats
Native inputs · 20 formats
| Document family | File extensions |
|---|---|
| PDF with native text | .pdf |
| Word & rich text | .doc, .docx, .rtf |
| Presentations | .ppt, .pptx |
| Spreadsheets | .xls, .xlsx, .csv, .tsv |
| OpenDocument | .odt, .ods, .odp |
| E-books | .epub |
| Web documents | .html, .htm, .shtml |
| Web archives | .mhtml, .mht |
| Open Fixed-layout Document | .ofd |
Outputs · 7 formats
| Output | --format / output_format |
|---|---|
| Markdown | markdown |
| HTML | html |
| LaTeX | latex |
| Word document | docx |
| EPUB e-book | epub |
pdf |
|
| Structured JSON | structured_content |
PPT/PPTX and XLS/XLSX are input formats only. Structured JSON is an export format; the document JSON protocol separately defines the analysis and intermediate representations.
Save now, export later
A Bundle packages the parsed document and its image assets for reuse across processes or machines. Load it whenever you need another output format:
import docvortex
result = docvortex.parse("report.pdf")
result.save_bundle("output/report.bundle")
restored = docvortex.load_bundle("output/report.bundle")
restored.export("output/report.epub", output_format="epub")
The restored result works without the original file. See the usage guide for Bundle contents, asset handling and overwrite rules.
Need only the title, authors or other source properties?
docvortex.extract_metadata()
reads metadata without parsing the document body.
Choose the right workflow
- Text PDFs: native parsing uses the document's existing text and structure. Scanned pages requiring OCR need an external OCR or inference service.
- PDF classification:
docvortex classify report.pdfreturnstxtorocr. Classification is explicit and does not start inference; parsing does not automatically switch backends. - PDF export: PDF sources with page geometry default to block layout restoration, with selectable text and HTML-based tables; charts retain region images. Other sources and older results use semantic reflow. Use
--pdf-layout original|reflowto select explicitly; fonts, line breaks and drawing instructions are not reproduced losslessly. See PDF output layout.
Documentation
| Guide | What you will find |
|---|---|
| Usage | Stage APIs, PDF pages, classification, images and Bundles |
| Agent skill | CLI and Python SDK workflows for agents; copy the entire skills/docvortex folder to reuse |
| Examples | Local samples for PDF, Office, EPUB, web documents and OFD with a runnable demo |
| Metadata | Source properties and per-format coverage |
| JSON protocol | Document schemas, extensions and protocol migration |
| HTML protocol | Semantic markers and round trips |
| Public SDK & migration | Supported integration boundaries and the 0.4 upgrade |
| Rendering ownership | DocVortex exports and MinerU-specific renderers |
Development
See Repository architecture for directory responsibilities, the Python/Rust boundary, and pure Python or native development commands.
From a local checkout:
uv venv
uv pip install -e ".[test,dev]"
uv run --no-project python -m pytest -q
uv run --no-project ruff check src
uv run --no-project ruff format --check src
uv build
Bug reports and contributions are welcome. When reporting a parsing issue, include a reproducible command and a sample document you can share in GitHub Issues.
License
DocVortex project code is released under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for docvortex 0.5.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| docvortex-0.5.12.tar.gz | 74.8 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| docvortex-0.5.12-py3-none-any.whl | Python 3 | none | any | Details |
| docvortex-0.5.12-cp310-abi3-win_arm64.whl | CPython 3.10 | abi3 | Windows ARM64 | Details |
| docvortex-0.5.12-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| docvortex-0.5.12-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| docvortex-0.5.12-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| docvortex-0.5.12-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
| docvortex-0.5.12-cp310-abi3-macosx_10_13_x86_64.whl | CPython 3.10 | abi3 | macOS 10.13+ x86-64 | Details |
Total release size: 109.5 MB
Release files / docvortex-0.5.12.tar.gz
| Download URL | docvortex-0.5.12.tar.gz |
|---|---|
| Size | 74.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8dc11e5169b2e1cdbf664e8dc14d40522d8bef0c2c877582baa71a6d66ece207
|
|
BLAKE2b-256 checksum How to use checksums |
a4a21a902c53b0aa793365d829691ac7b6b0c164100cb3c18ef026814366cdf0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-py3-none-any.whl
| Download URL | docvortex-0.5.12-py3-none-any.whl |
|---|---|
| Size | 3.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4e2398b26826530654309315ad39b3de5a1c90270380e80dfdbe1259bc709120
|
|
BLAKE2b-256 checksum How to use checksums |
99d0d637760bbb95650db8cb98b3eec26cb7ddc25f5d40e3bb547393bf8949a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-cp310-abi3-win_arm64.whl
| Download URL | docvortex-0.5.12-cp310-abi3-win_arm64.whl |
|---|---|
| Size | 5.0 MB |
| Tags | CPython 3.10 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
6ede5669a9fe39c60b5e6488cb06432e9ca4b98e09335e45fb8d94ce3043a276
|
|
BLAKE2b-256 checksum How to use checksums |
40c544e2caf5dd0a3c0899098045f6c43599cf69da9e74f9b4c3ce809d7c5cac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-cp310-abi3-win_amd64.whl
| Download URL | docvortex-0.5.12-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 5.1 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
bc2ea61c8902e9747debb04c0756fcbbe69e8b201ac0631c08964ce377efbef2
|
|
BLAKE2b-256 checksum How to use checksums |
f69839f7f4550f8c2303e73f3b24eaa4c66efd9dc122f7a0893d2c573d6707e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | docvortex-0.5.12-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 5.2 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1cf0688904034c2d3935fb688a385f01482dda41746c591c1801d16e1d8beb8f
|
|
BLAKE2b-256 checksum How to use checksums |
cde3f49d6185137fe6011e1c2aff58cdaae43a8c457b8e482d95181cec1fb5da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | docvortex-0.5.12-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.1 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
0ac4d2e26f5074c6ce691f9c284d6d842eb0740f6f9818d7468324e5ba607fe3
|
|
BLAKE2b-256 checksum How to use checksums |
67c9182d6f034557104cdfc4e686d196f6a51d957bef124b59fbe244a0f3466d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | docvortex-0.5.12-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 5.1 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4524a4cb97b148955bd8f9f14b14ccfd63b0d034e9587cec6f1847b0191330f7
|
|
BLAKE2b-256 checksum How to use checksums |
e060598c40a63ec28d6ea3abd17010ff925e43e6337f2abe473243e5ae00f028
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / docvortex-0.5.12-cp310-abi3-macosx_10_13_x86_64.whl
| Download URL | docvortex-0.5.12-cp310-abi3-macosx_10_13_x86_64.whl |
|---|---|
| Size | 5.2 MB |
| Tags | CPython 3.10 abi3 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
feec63a6d37dde244924dc4c3d8d684a2b1c6c52ff9b3eee86d68c8517fdaeb9
|
|
BLAKE2b-256 checksum How to use checksums |
6e3b3f82c9b4e972c566ac5d4102854c7debde51afd8ce30f2fac20a95a719a0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency log
