Work in progress — this reference is being written in the open. Unfinished pages are excluded from search engines.
Paged · IDML Reference
Foundations

Foundations

Start here — what IDML is, where it came from, why it is packaged the way it is, and how to read one by hand.

Beginner· explanation

Foundations is the on-ramp: what IDML is, where it came from, and how to open one yourself.

In short: This section is the starting point for the whole reference. It answers the first question every reader has — what is this thing? — and works up from there: what IDML is, why an XML form exists at all, why it ships as a package of many parts, and how to crack one open and read it by hand. Nothing here assumes prior knowledge. By the end you will know what is inside an IDML file, why it is shaped that way, and how to look at one yourself.

You do not need to know anything about page layout, XML, or Adobe® InDesign® to start. Each page builds on the last, in the order a curious reader would actually ask the questions. Read them top to bottom the first time through; come back to any one of them later as a standalone explainer.

Frequently asked questions

Where should I start if I am new to IDML? Start at the top of this section with What IDML is, then read the pages in order. They assume no prior knowledge and each one builds on the page before it, so by the end you will understand what an IDML file holds and how to open one yourself.

Do I need to know InDesign or XML to follow these pages? No. The Foundations pages are written for readers with no background in page layout, XML, or Adobe® InDesign®. They explain the few concepts you need as they come up, in plain English.

What does this section cover, and what comes after it? Foundations covers the what and why of IDML — what it is, where it came from, why it is a package, and how to read one. Once you have that footing, the package anatomy section digs into the individual parts and how they reference each other.

Paged brings enterprise Desktop Publishing directly to the web. No more bloated applications. No more hidden, proprietary technologies. Just as Scribus and others democratized DTP before it, Paged sets out to open this domain up to everyone — leveraging modern technologies like WebGPU and WebAssembly to deliver professional-grade publishing performance natively in the browser.

At its core, Paged is an open-source IDML parser and renderer. It reads IDML files, parses them, and renders them faithfully on the web.

Paged also aims to be the open IDML reference — an easily accessible, authoritative resource providing deep insight into the structure and inner workings of the IDML format, which has long been underdocumented and locked behind proprietary tooling.

Three things working in concert: a mission to democratize Desktop Publishing for the web era, a faithful open IDML engine, and the definitive open reference for the format.

Paged and paged.media are an open project from And The Next GmbH. Find the repositories at github.com/paged-media.


Paged is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Adobe Inc. IDML and InDesign are referenced solely for interoperability and descriptive purposes. We are deeply grateful to Adobe for opening up the IDML format for exchange, and thank them wholeheartedly for making projects like this possible.

Documentation content is licensed CC BY 4.0; site code is licensed MIT.

On this page