Skip to main content

ICML (Adobe InCopy) format (.icml, .wcml)

ICML (InCopy Markup Language) is the XML-based format Adobe InDesign and InCopy use for editorial workflows. Unlike its IDML sibling, an .icml (or .wcml) file is a single XML document rather than a ZIP package. The reader descends Story → ParagraphStyleRange → CharacterStyleRange → Content runs, emitting one translatable Block per visible text payload.

neokapi reads and writes ICML/WCML, preserving the surrounding style ranges and document structure as skeleton. By default it does not extract note content, and it groups paragraph text rather than starting a new translation unit at each line break — both matching the upstream Okapi ICML filter defaults. The native reader applies the same defaults but does not expose them as a configurable JSON schema in this reference.

IDicml
SourceBuilt-in
Extensions.icml, .wcml
MIME Typesapplication/x-icml+xml
CapabilitiesRead + Write

This format has no configurable parameters.

Processing notes

  • One translatable Block per visible Content run, walking Story → ParagraphStyleRange → CharacterStyleRange.

  • Style ranges and the document structure are preserved as skeleton for round-trips.

  • Handles both .icml and .wcml extensions.

Limitations

  • Note content is not extracted by default.

  • Extraction and segmentation toggles match the upstream Okapi ICML filter but are not surfaced as configurable schema properties in this reference.

Reference documentation

← Back to the Format Reference