v0.1.0
DOCX/XLSX → Markdown conversion that treats embedded charts and composite figures as first-class content instead of silently dropping or fragmenting them.
Highlights
- Native OOXML chart-data extraction — reads
numCache/strCachestraight from the chart XML, no rasterize/OCR/VLM. Validated against 407 real charts across 27 real-world documents (400 render as mermaid diagrams). - Zero-loss composite-figure markers — grouped shapes/infographics get a positioned marker with caption preserved, instead of the silent fragmentation most DOCX converters produce (see Docling #1287, open >1 year, unfixed).
- Optional VLM interpretation (implemented, not yet promoted as a headline v1 feature) — provider-agnostic cloud description + mermaid diagram on top of the zero-loss floor.
- Rich, typed API —
ConversionResult(markdown + warnings + counts), typed exceptions,strictmode, path/bytes/file-like input. - CLI (
refigurecommand) — single-file and batch conversion. - Lightweight —
refigure[docx,xlsx]installs at ~5.6MB, no PyTorch/CUDA stack. - 100% combined test coverage (unit + integration), gated in CI.
Scope: DOCX + XLSX only — PDF is deliberately out of scope (see README).
pip install "refigure[docx,xlsx]"
Full details: README.