SPB Git

Repository Public

docx-compatibility.md 8.4 KB

# DOCX compatibility report (measured)

Generated 2026-11-21T06:47:05Z by Scripts/docx-compat.sh (test CompatibilityReportTests.corpusCycle). Every number below was measured during that run.

  • pandoc: pandoc 3.9.0.2
  • LibreOffice: LibreOffice 26.8.2.2 9dea406ab7695df6325b11b0e19fdca8db4b7276
  • textutil: available (macOS)
  • Microsoft Word: not used. Nothing in this report is a statement about how Word itself opens these files.

# Cycle

Each document goes through Import → Export → Reimport → Export → Reimport. "Model equal" compares the whole document model (text, formatting, structure, notes, comments, revisions, assets, preserved parts) with generated identifiers ignored.

Measure Result
Documents 19
Imported without error 19 / 19
Model equal after the first cycle (import vs reimport) 19 / 19
Model equal after the second cycle 19 / 19
Words in the corpus (body and notes, as imported) 526
Text integrity after two cycles (word-weighted) 100.00 %
Feature checks passed / failed (feature × document) 172 / 0
Import warnings: info / approximated / dropped 11 / 8 / 26
Export warnings (all severities) 2

# Independent readers

Measure Result
pandoc reads our export 19 / 19
Words pandoc reads in the original that it also reads, in order, in our export (mean) 97.9 %
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 %
textutil reads our export 19 / 19
Words textutil reads in the original that it also reads in our export (mean) 96.4 %
LibreOffice converts our export to PDF 19 / 19

Agreement below 100 % is expected where the tools and ORIX Docs deliberately differ: pandoc and textutil print cached field results, generated contents (and their title) and bibliographies as text, while ORIX Docs imports them as fields and generated blocks and recomputes them; pandoc keeps the text of a tracked move at its origin while ORIX Docs imports it as a deletion; hand-authored fixtures contain stale cached field text on purpose.

# Per document

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)
libreoffice-merged.docx LibreOffice 30 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 5
libreoffice-pagesetup.docx LibreOffice 37 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 6
pandoc-basic.docx pandoc 59 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-footnotes.docx pandoc 36 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-images.docx pandoc 9 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-lists.docx pandoc 28 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-math.docx pandoc 11 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-tables.docx pandoc 30 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-toc.docx pandoc 14 yes / yes 100.0 % 86.7 % yes (100.0 %) yes (100.0 %) yes 1 / 0 / 1
pandoc-unicode.docx pandoc 29 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (92.9 %) yes 1 / 0 / 1
hand-tracked-changes.docx hand-authored OOXML 8 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (77.8 %) yes 0 / 1 / 0
hand-comments.docx hand-authored OOXML 12 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 0 / 0 / 0
hand-fields.docx hand-authored OOXML 36 yes / yes 100.0 % 64.3 % yes (78.6 %) yes (75.9 %) yes 0 / 2 / 0
hand-drawings.docx hand-authored OOXML 19 yes / yes 100.0 % 84.6 % yes (88.9 %) yes (85.7 %) yes 0 / 1 / 7
hand-tables.docx hand-authored OOXML 17 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 0 / 1 / 0
hand-sections.docx hand-authored OOXML 24 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 0 / 1 / 0
hand-styles-lists.docx hand-authored OOXML 35 yes / yes 100.0 % 100.0 % yes (100.0 %) yes (100.0 %) yes 1 / 1 / 0
hand-equations.docx hand-authored OOXML 3 yes / yes 100.0 % 100.0 % yes (92.9 %) yes (100.0 %) yes 0 / 1 / 0
orix-rich.docx ORIX Docs model 89 yes / yes 100.0 % 88.7 % yes (100.0 %) yes (100.0 %) yes 0 / 0 / 0

# Per feature

A 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.

Feature Documents that contain it Instances Pass Fail
bibliography blocks 1 1 1 0
bibliography entries 1 1 1 0
bold runs 6 9 6 0
bookmarks 10 18 10 0
citations 1 1 1 0
comment replies 2 2 2 0
commented runs 2 5 2 0
comments 2 4 2 0
cross-references 2 5 2 0
endnote references 2 2 2 0
equations 3 10 3 0
fields 4 21 4 0
footer paragraphs 3 12 3 0
footnote references 3 6 3 0
generated lists (TOC) 2 2 2 0
header paragraphs 3 12 3 0
headings 12 21 12 0
hyperlink runs 4 8 4 0
image assets 3 4 3 0
images 3 6 3 0
italic runs 5 5 5 0
list definitions 11 22 11 0
list items 4 31 4 0
merged cells 4 11 4 0
notes 3 8 3 0
page and column breaks 2 3 2 0
paragraphs 19 201 19 0
preserved parts 11 48 11 0
section breaks 3 6 3 0
shapes 1 1 1 0
styles 19 699 19 0
table cells 5 58 5 0
table rows 5 22 5 0
tables 5 6 5 0
tracked deletions 2 3 2 0
tracked format changes 1 1 1 0
tracked insertions 2 4 2 0
tracked paragraph marks 1 2 1 0

# Import warnings by document

Warnings of severity approximated or dropped raised while importing (the hand-authored packages contain unsupported content on purpose).

  • libreoffice-merged.docx: dropped: Other paragraph formatting
  • libreoffice-pagesetup.docx: dropped: Other paragraph formatting
  • pandoc-basic.docx: dropped: Other paragraph formatting
  • pandoc-footnotes.docx: dropped: Other paragraph formatting
  • pandoc-images.docx: dropped: Other paragraph formatting
  • pandoc-lists.docx: dropped: Other paragraph formatting
  • pandoc-math.docx: dropped: Other paragraph formatting
  • pandoc-tables.docx: dropped: Other paragraph formatting
  • pandoc-toc.docx: dropped: Other paragraph formatting
  • pandoc-unicode.docx: dropped: Other paragraph formatting
  • hand-tracked-changes.docx: approximated: Tracked moves
  • hand-fields.docx: approximated: Cross-references; approximated: Fields
  • hand-drawings.docx: approximated: Text boxes; dropped: Charts; dropped: Embedded objects; dropped: Linked pictures; dropped: SmartArt; dropped: Unsafe relationship; dropped: Unsupported content
  • hand-tables.docx: approximated: Nested tables
  • hand-sections.docx: approximated: Page breaks inside paragraphs
  • hand-styles-lists.docx: approximated: Symbol characters
  • hand-equations.docx: approximated: Equations

# Limits of this report

  • 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.
  • "Model equal" proves that ORIX Docs reads back what it writes. It does not prove that another application renders the file the same way.
  • Layout (line breaks, pagination, fonts) is not measured anywhere in this report.
  • Microsoft Word was not launched; no claim is made about Word.
Files main
Menu

Theme