Convert RST to ICML

Turn RST files into ICML. An InDesign ICML story with headings, lists, tables, links and footnotes, every element in a paragraph or character style named after it so a layout can restyle it.

Converted in an isolated sandbox on our serversDeleted after 24 hours

Drop RST files on the dialor turn it to pick what to do

An InDesign story from your RST.Headings, lists, tables, links and footnotes carry over as styled text.

  1. What you get

    One ICML file, an InDesign story you can place into a layout. Headings, lists, tables, links and footnotes are all in it.

    Every element sits in a paragraph or character style named after it. A layout can restyle each element by changing that style.

  2. What changes or is dropped

    Directives that only Sphinx knows, such as toctree, keep just their text. The directive itself does not carry over.

    Comments are dropped. Images stay as links, so the picture files are not placed inside the story.

RST and ICML.What each format is.

The formats

From · RST

reStructuredText

reStructuredText, the markup of Python documentation and Sphinx.

Extensions
.rst
MIME type
text/x-rst
Kind
Text and data
To · ICML

InDesign ICML

InCopy Markup Language, the story file that InDesign places into a layout with its paragraph and character styles.

Extensions
.icml
MIME type
application/vnd.adobe.incopy-icml+xml
Kind
Text and data

In your code.The same RST to ICML conversion through the API, for your app or your agent.

terminal
$ cv convert report.rst report.icml
$ cv convert report.rst report.icml

Questions.What people ask about RST to ICML.

01OF 04

Yes. Each element is in a paragraph or character style named after it, so you change the style in the layout to restyle every element of that kind.

It keeps only its text. Sphinx-only directives like it are not rebuilt in the ICML file.

No. Images stay as links to the picture files.

No. Comments are dropped from the ICML file.

More conversions.Other ways in and out of RST and ICML.