InDesign 5.0 destinations have no key, hyperlinks name their destination by UID, text destination owners use chunk 0x1351E, and text sources are placed by start and end markers owned by the story (chunk 0x13524) instead of a range tree. These are read by version; keys are left out where there are none. No 5.0 file has an IDML. Over the 17 5.0 files with hyperlinks: 121 hyperlinks, 118 text sources, 7 text destinations and 45 bookmarks are now written, the 116 warnings about their destination objects are gone, and every output validates. Pair results unchanged (91.92 %, extra values 26,516). Schema validation: 0 failures.
indd-utils
Reads INDD files, the native document format of Adobe® InDesign®, without
InDesign, and converts them to IDML. The crate and the command are both
named indd.
Adobe and InDesign are trademarks of Adobe Inc. This project is not affiliated with or endorsed by Adobe.
Status
The converter turns INDD and INDT files into IDML packages. Every output from the test corpus validates against the IDML RelaxNG schemas. It writes the document structure, pages, page items, placed graphics, story text with its formatting, styles, swatches, tables, hyperlinks, fonts and XML structure. Many attributes are still missing (see Current numbers), so the output is not yet the same as InDesign's own IDML export.
The format is undocumented. Every fact the converter relies on was found
by comparing INDD files with IDML files exported from the same
documents, and is recorded with its evidence in docs/format/.
CLEANROOM.md describes the method and its limits.
Use
Build from source with a recent stable Rust:
cargo build --release
./target/release/indd convert in.indd out.idml
| Command | Output |
|---|---|
indd convert <in.indd> <out.idml> |
IDML package. Problems that do not stop the conversion are printed to stderr as warning: …. |
indd info <file.indd>... |
Header, master page and container summary |
indd objects <file.indd> |
One line per database object: UID, class, length, first bytes |
indd object <file.indd> <uid> |
One object's bytes, to stdout |
indd dump [--full] <file.indd> <uid>... |
The objects' chunks in hex |
indd uids <file.indd> |
One line per object: UID and class, without reading object data |
indd xmp <file.indd> |
The document's XMP packet |
indd audit [--tsv] <file.indd> |
What the converter does not read in the document |
INDT templates are read the same way as INDD files.
As a library:
let conversion = indd::convert_file("brochure.indd")?;
std::fs::write("brochure.idml", &conversion.idml)?;
for warning in &conversion.warnings {
eprintln!("warning: {warning}");
}
indd::convert(bytes, name) converts bytes in memory and
indd::convert_into(bytes, name, writer) writes the package to a
writer. A conversion keeps no global state, so several documents can be
converted on different threads at once.
Supported versions
| Versions | Distinct samples (little-endian, big-endian) | State |
|---|---|---|
| InDesign 3.0 and 4.0 | 21, 46 | Convert. Some object layouts differ from later versions (big-endian.md). Document preferences, object style text frame settings, the composite font (3.0) and the page number style (3.0) are left out with warnings. |
| InDesign 5.0 and 6.0 | 175, 6 | Convert. Document preferences are left out with a warning. |
| InDesign 7.0–7.5 | 526, 40 | Convert. Document preferences are left out with a warning. |
| InDesign 8.0–21.6 | 3,368, 70 | Convert. Tables from 9.2 are not read. |
The byte order flag in the header applies to object data only; the database pages are little-endian in every file.
What converts
Each area below links to the document that holds the evidence.
| Area | Converted |
|---|---|
| Document structure | Spreads, master spreads, layers, sections (start, length, continued numbering, Arabic and lower-case Roman page numbers), the story list. objects.md |
| Pages and masters | Page bounds, transforms, applied master, margins and columns, page names, ruler guides, master names and prefixes. objects.md |
| Page items and graphics | Text frames (with threading), rectangles, ovals, polygons, graphic lines and groups: transforms, paths, fill and stroke, corners, applied object style, text wrap, frame fitting, anchored objects. Placed images, PDF, EPS and SVG with their bounds, clipping path settings and links; graphics pasted without a link keep their data. Transparency: blending, drop shadow, inner shadow and gradient feather where the samples tell the attributes apart. objects.md, attributes.md, transparency.md |
| Text and typography | Story text, paragraph and character ranges with their local formatting (100 text attributes, among them font, size, leading, tracking, indents, spacing, tabs, rules, shading, borders, bullets and numbering, nested styles, span columns, languages), text frame settings, text variables and their instances. attributes.md, text-variables.md |
| Styles | Paragraph, character, object, cell and table styles, with style groups, BasedOn and NextStyle. objects.md, tables.md |
| Colours and swatches | Process, spot and registration colours, tints, gradients, inks, colour groups, the None swatch. objects.md |
| Tables | Tables in stories and in cells: rows, columns, headers and footers, cells with spans, cell text, cell and table formatting, applied styles. tables.md |
| Links and cross-references | Hyperlinks with text sources, page and URL destinations, bookmarks, cross-reference formats. hyperlinks.md, cross-references.md |
| Fonts | Font families and fonts with their names, styles, types and PostScript names; composite font entries. fonts.md |
| CJK | Kinsoku and mojikumi tables, composite fonts, grid alignment of paragraphs. objects.md, fonts.md |
| XML | Tags, the XML structure with elements placed in story text, the backing story. xml.md |
| Document lists | Index sort groups, TOC styles, trap presets, the language list, named grids, document users. objects.md, idml-values.md |
| Preferences | Page size, facing pages, bleed and intent from the INDD. The other preference values, and the values every InDesign export has on the root styles, are written as observed in all reference IDML files. idml-values.md |
What does not convert
Reasons:
- Not in public samples: no sample with an IDML has the feature, so there is nothing to compare against.
- Not provable: the samples have the feature, but every sample has the same value, so the fields cannot be told apart.
- Not started: the samples have it, and no one has worked on it yet.
| Feature | Reason |
|---|---|
| Cross-reference sources, hyperlink text destinations, page item sources | Not in public samples |
| Footnotes, endnotes, notes, conditional text, index topics, buttons and forms | Not in public samples |
| Ruby, kenten, warichu, tate-chu-yoko | Not in public samples |
| XML attributes, comments, processing instructions, DTDs; XML elements that cross paragraphs | Not in public samples (left out with a warning) |
| Hyperlink sources that cross a style range | Not in public samples with an IDML (left out with a warning) |
| Most transparency effects (glows, bevel, satin, feathers other than gradient), drop shadow offsets | Not provable |
| Table and cell border weights, colours and types; cell edge gap colours | Not provable |
Font Status, variable font design axes |
Not provable (Status depends on the exporting machine) |
Many attributes with one value in nearly every sample (Visible, Locked, Name of page items, …) |
Not provable |
| Tables from InDesign 9.2 | Not started (different layout) |
| Document preferences from InDesign 3.0–7.5, object style text frame settings from 4.0 | Not started (different layouts) |
| Group transforms: most groups have no transform chunk, and the identity transform written differs from the reference for 275 of 289 groups | Not started |
| Transparency of placed graphics and object styles | Not started |
| Link metadata other than the URI and state | Not started |
| Text on a path, QR codes | Not started |
How fidelity is measured
The local test corpus holds INDD and INDT files made by other people for
other purposes. It is not redistributed. 654 distinct files come with an
IDML that InDesign exported from the same document at the same major
version. In 489 of these pairs the IDML shows the same save as the INDD
(trustworthy pairs); the others were saved again after the export
(docs/measurement.md).
tools/compare.pyconverts each paired file and compares the output with InDesign's IDML. Elements are matched bySelf(the INDD UID). The headline is value coverage: the share of the reference's values that the output reproduces.tools/compare.py --allalso converts the files without a usable IDML.- With
--schemasand--jing, every output is validated against the IDML RelaxNG schemas with Jing (tools/validate.sh). cargo testruns unit tests, smoke tests on the open-licensed samples listed intests/fixtures/manifest.json(fetch them first withpython3 -I tools/fetch_fixtures.py) and, ifcorpus/exists, tests over the corpus.
Current numbers
From tools/compare.py --all with schema validation, without the
privately held samples:
| Measure | Result |
|---|---|
| Conversion failures | 0 of 654 paired files; 22 of 3,618 other files, all of them not INDD files or truncated |
| Schema validation failures | 0 |
| Value coverage, trustworthy pairs | 88.72 % (9,885,604 of 11,142,835 values) |
| Value coverage, all pairs | 86.81 % |
| Story text, trustworthy pairs | 18,509 of 18,610 stories exact, 100 differ, 1 missing |
The biggest remaining gaps are elements the converter does not write
yet (hyperlinks in some documents, page references, footnote options of
text frames, EPS text, graphic layers) and attributes that have one value
in nearly every sample, so that their INDD fields cannot be located.
compare.py lists them, and writes per-key tables to target/compare/.
Development
CONTRIBUTING.md: the clean-room rules, the checks to run, and how to add an attribute, element or constant value end to end. ReadCLEANROOM.mdfirst.ARCHITECTURE.md: layers, data flow, module map, and how the generated value files work.python3 -I tools/fetch_fixtures.pydownloads the test fixtures.cargo test,cargo clippy --all-targets,cargo fmt.python3 -I tools/compare.py [--all] [--detail TAG --show N] [--schemas DIR --jing DIR]after every change. The schemas and Jing are not part of the repository; seetools/validate.sh.python3 -I tools/diff_outputs.py [OLD [NEW]]compares the output of two revisions over the corpus; a refactoring must change none.python3 -I tools/inventory.py corpus/lists each sample's InDesign version and whether it has a matching IDML file.
Licence
Dual-licensed under MIT or Apache-2.0, at
your option. Copyright (c) 2026 aiongg and the indd-utils contributors.
The repository contains no sample files. The test fixtures are
downloaded from their sources and keep their own licences; see
tests/fixtures/README.md.