Repository Public
1<!--2ORIX Docs3File: docs/reports/docx-compatibility.md4Description: Measured DOCX compatibility of the ORIX Docs engine on the reference corpus. Generated file — do not edit; run Scripts/docx-compat.sh.5Author: Simon-Pierre Boucher6Contact: contact@spboucher.ai7-->8# DOCX compatibility report (measured)910Generated 2026-11-21T06:47:05Z by `Scripts/docx-compat.sh` (test `CompatibilityReportTests.corpusCycle`). Every number below was measured during that run.1112* pandoc: pandoc 3.9.0.213* LibreOffice: LibreOffice 26.8.2.2 9dea406ab7695df6325b11b0e19fdca8db4b727614* textutil: available (macOS)15* Microsoft Word: **not used**. Nothing in this report is a statement about how Word itself opens these files.1617## Cycle1819Each document goes through Import → Export → Reimport → Export → Reimport. "Model equal" compares the whole document model20(text, formatting, structure, notes, comments, revisions, assets, preserved parts) with generated identifiers ignored.2122| Measure | Result |23|---|---|24| Documents | 19 |25| Imported without error | 19 / 19 |26| Model equal after the first cycle (import vs reimport) | 19 / 19 |27| Model equal after the second cycle | 19 / 19 |28| Words in the corpus (body and notes, as imported) | 526 |29| Text integrity after two cycles (word-weighted) | 100.00 % |30| Feature checks passed / failed (feature × document) | 172 / 0 |31| Import warnings: info / approximated / dropped | 11 / 8 / 26 |32| Export warnings (all severities) | 2 |3334## Independent readers3536| Measure | Result |37|---|---|38| pandoc reads our export | 19 / 19 |39| Words pandoc reads in the original that it also reads, in order, in our export (mean) | 97.9 % |40| Words in pandoc's AST of the original (text and code; math and image alternative text excluded) that our importer also has, in order (mean) | 96.0 % |41| textutil reads our export | 19 / 19 |42| Words textutil reads in the original that it also reads in our export (mean) | 96.4 % |43| LibreOffice converts our export to PDF | 19 / 19 |4445Agreement below 100 % is expected where the tools and ORIX Docs deliberately differ: pandoc and textutil print cached field46results, generated contents (and their title) and bibliographies as text, while ORIX Docs imports them as fields and47generated blocks and recomputes them; pandoc keeps the text of a tracked move at its origin while ORIX Docs imports it as48a deletion; hand-authored fixtures contain stale cached field text on purpose.4950## Per document5152| Document | Source | Words | Model = after cycle 1 / 2 | Text after 2 cycles | Import vs pandoc | pandoc reads export (text) | textutil reads export (text) | LibreOffice PDF | Import warnings (info / approx. / dropped) |53|---|---|---:|---|---:|---:|---|---|---|---|54| `libreoffice-merged.docx` | LibreOffice | 30 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 5 |55| `libreoffice-pagesetup.docx` | LibreOffice | 37 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 6 |56| `pandoc-basic.docx` | pandoc | 59 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |57| `pandoc-footnotes.docx` | pandoc | 36 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |58| `pandoc-images.docx` | pandoc | 9 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |59| `pandoc-lists.docx` | pandoc | 28 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |60| `pandoc-math.docx` | pandoc | 11 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |61| `pandoc-tables.docx` | pandoc | 30 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |62| `pandoc-toc.docx` | pandoc | 14 | yes / yes | 100.0 % | 86.7 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 0 / 1 |63| `pandoc-unicode.docx` | pandoc | 29 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (92.9 %) | yes | 1 / 0 / 1 |64| `hand-tracked-changes.docx` | hand-authored OOXML | 8 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (77.8 %) | yes | 0 / 1 / 0 |65| `hand-comments.docx` | hand-authored OOXML | 12 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 0 / 0 / 0 |66| `hand-fields.docx` | hand-authored OOXML | 36 | yes / yes | 100.0 % | 64.3 % | yes (78.6 %) | yes (75.9 %) | yes | 0 / 2 / 0 |67| `hand-drawings.docx` | hand-authored OOXML | 19 | yes / yes | 100.0 % | 84.6 % | yes (88.9 %) | yes (85.7 %) | yes | 0 / 1 / 7 |68| `hand-tables.docx` | hand-authored OOXML | 17 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 0 / 1 / 0 |69| `hand-sections.docx` | hand-authored OOXML | 24 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 0 / 1 / 0 |70| `hand-styles-lists.docx` | hand-authored OOXML | 35 | yes / yes | 100.0 % | 100.0 % | yes (100.0 %) | yes (100.0 %) | yes | 1 / 1 / 0 |71| `hand-equations.docx` | hand-authored OOXML | 3 | yes / yes | 100.0 % | 100.0 % | yes (92.9 %) | yes (100.0 %) | yes | 0 / 1 / 0 |72| `orix-rich.docx` | ORIX Docs model | 89 | yes / yes | 100.0 % | 88.7 % | yes (100.0 %) | yes (100.0 %) | yes | 0 / 0 / 0 |7374## Per feature7576A feature passes for a document when the number of its instances is the same after the import, after the first cycle and after the second cycle.7778| Feature | Documents that contain it | Instances | Pass | Fail |79|---|---:|---:|---:|---:|80| bibliography blocks | 1 | 1 | 1 | 0 |81| bibliography entries | 1 | 1 | 1 | 0 |82| bold runs | 6 | 9 | 6 | 0 |83| bookmarks | 10 | 18 | 10 | 0 |84| citations | 1 | 1 | 1 | 0 |85| comment replies | 2 | 2 | 2 | 0 |86| commented runs | 2 | 5 | 2 | 0 |87| comments | 2 | 4 | 2 | 0 |88| cross-references | 2 | 5 | 2 | 0 |89| endnote references | 2 | 2 | 2 | 0 |90| equations | 3 | 10 | 3 | 0 |91| fields | 4 | 21 | 4 | 0 |92| footer paragraphs | 3 | 12 | 3 | 0 |93| footnote references | 3 | 6 | 3 | 0 |94| generated lists (TOC) | 2 | 2 | 2 | 0 |95| header paragraphs | 3 | 12 | 3 | 0 |96| headings | 12 | 21 | 12 | 0 |97| hyperlink runs | 4 | 8 | 4 | 0 |98| image assets | 3 | 4 | 3 | 0 |99| images | 3 | 6 | 3 | 0 |100| italic runs | 5 | 5 | 5 | 0 |101| list definitions | 11 | 22 | 11 | 0 |102| list items | 4 | 31 | 4 | 0 |103| merged cells | 4 | 11 | 4 | 0 |104| notes | 3 | 8 | 3 | 0 |105| page and column breaks | 2 | 3 | 2 | 0 |106| paragraphs | 19 | 201 | 19 | 0 |107| preserved parts | 11 | 48 | 11 | 0 |108| section breaks | 3 | 6 | 3 | 0 |109| shapes | 1 | 1 | 1 | 0 |110| styles | 19 | 699 | 19 | 0 |111| table cells | 5 | 58 | 5 | 0 |112| table rows | 5 | 22 | 5 | 0 |113| tables | 5 | 6 | 5 | 0 |114| tracked deletions | 2 | 3 | 2 | 0 |115| tracked format changes | 1 | 1 | 1 | 0 |116| tracked insertions | 2 | 4 | 2 | 0 |117| tracked paragraph marks | 1 | 2 | 1 | 0 |118119## Import warnings by document120121Warnings of severity *approximated* or *dropped* raised while importing (the hand-authored packages contain unsupported content on purpose).122123* `libreoffice-merged.docx`: dropped: Other paragraph formatting124* `libreoffice-pagesetup.docx`: dropped: Other paragraph formatting125* `pandoc-basic.docx`: dropped: Other paragraph formatting126* `pandoc-footnotes.docx`: dropped: Other paragraph formatting127* `pandoc-images.docx`: dropped: Other paragraph formatting128* `pandoc-lists.docx`: dropped: Other paragraph formatting129* `pandoc-math.docx`: dropped: Other paragraph formatting130* `pandoc-tables.docx`: dropped: Other paragraph formatting131* `pandoc-toc.docx`: dropped: Other paragraph formatting132* `pandoc-unicode.docx`: dropped: Other paragraph formatting133* `hand-tracked-changes.docx`: approximated: Tracked moves134* `hand-fields.docx`: approximated: Cross-references; approximated: Fields135* `hand-drawings.docx`: approximated: Text boxes; dropped: Charts; dropped: Embedded objects; dropped: Linked pictures; dropped: SmartArt; dropped: Unsafe relationship; dropped: Unsupported content136* `hand-tables.docx`: approximated: Nested tables137* `hand-sections.docx`: approximated: Page breaks inside paragraphs138* `hand-styles-lists.docx`: approximated: Symbol characters139* `hand-equations.docx`: approximated: Equations140141## Limits of this report142143* The corpus is small (19 documents) and mostly synthetic; it measures the engine on the features listed in `docs/compatibility/docx.md`, not on arbitrary real-world documents.144* "Model equal" proves that ORIX Docs reads back what it writes. It does not prove that another application renders the file the same way.145* Layout (line breaks, pagination, fonts) is not measured anywhere in this report.146* Microsoft Word was not launched; no claim is made about Word.147