Learning in public — this documentation is written in the open and updated as the engine moves.

The IDML
reference

An independent, in-depth reference for IDML, the open XML package an InDesign document becomes when it travels as text: the package, spreads and pages, stories, styles, tables, colour and graphics. Written from first principles, with every example validated against a working renderer.

Engraved portrait of Johannes Gutenberg
Frontispiece · Johannes Gutenberg
c. 1400–1468

One page, one tier, one job.

Every page is written for a single reader and a single task. Filter the whole reference to your depth — no traffic lights, just the shape of the page you’re about to read.

I

Beginner

Plain-language explanations. Start here if IDML or paged media is new to you.

II

Intermediate

Working knowledge — package structure, stories, styles, and how pages compose.

III

Pro

Deep reference — geometry, edge cases, and the format in full.