# InDesign: importar, exportar e portar

> Os dois caminhos para trazer um livro do InDesign para o Postext, o importador de IDML, que copia o que o documento contém, e a skill para agentes, que deduz as regras de diagramação dele; quando usar cada um, e como o exportador de IDML devolve um livro ao InDesign

- Versão HTML: https://postext.dev/pt/docs/indesign
- Última atualização: 2026-11-14
- Tempo de leitura: 9 min
- Outros idiomas: [en](https://postext.dev/en/docs/indesign.md), [es](https://postext.dev/es/docs/indesign.md), [ca](https://postext.dev/ca/docs/indesign.md), [de](https://postext.dev/de/docs/indesign.md), [fr](https://postext.dev/fr/docs/indesign.md), [it](https://postext.dev/it/docs/indesign.md), [zh](https://postext.dev/zh/docs/indesign.md), [ja](https://postext.dev/ja/docs/indesign.md), [ar](https://postext.dev/ar/docs/indesign.md)

## Em poucas palavras

O Postext pode trazer um livro feito no InDesign de dois jeitos. O importador copia o que o arquivo do InDesign contém: cada página, cada quadro e cada estilo como estão. É rápido, mas o resultado é uma cópia das páginas antigas, difícil de mudar e de traduzir. Já a skill para agentes estuda o livro: o arquivo, o PDF de impressão, as fontes e as imagens. Ela descobre as regras que o designer seguiu e refaz o livro a partir delas, com o texto livre para correr, e assim sai um livro melhor, que é o que recomendamos. Esta página explica os dois jeitos, quando cada um serve e como o Postext devolve um livro pronto ao InDesign.

**Um livro feito no InDesign pode entrar no Postext copiando as páginas ou deduzindo o design. Recomendamos deduzir o design.**

O Postext lê e grava pacotes InDesign Markup (`.idml`), o arquivo que o InDesign salva com **Arquivo › Salvar como › InDesign Markup (IDML)**. Três ferramentas os usam:

- o **importador**, que transforma um `.idml` em um livro do Postext;
- a **skill para agentes** [`postext-port`](https://postext.dev/pt/docs/skill.md), que porta um livro a partir de todos os originais dele, entre eles o `.idml`;
- o **exportador**, que grava um livro do Postext como `.idml` para um designer finalizar no InDesign.

O importador e a skill trazem os dois um livro, e não dão o mesmo livro. Esta página explica a diferença para você poder escolher.

> [InDesign, entra e sai: importar, portar e exportar livros do InDesign com o Postext](https://youtu.be/mjyGcX7TEgg) · 4:23

## Dois caminhos para o Postext

Um documento do InDesign é um conjunto de páginas que alguém fez à mão. O designer seguiu regras, como um corpo de letra, uma grade, o jeito de abrir um capítulo, o lugar de um boxe ou como uma legenda fica embaixo da sua figura. O `.idml` guarda o resultado de aplicar essas regras, quadro a quadro, e não registra as regras.

**O importador copia o resultado.** Ele lê o pacote e grava o que encontra: cada quadro onde estava, cada estilo com os seus valores, cada imagem e cada tabela como recurso. Nada é adivinhado, e o mesmo arquivo dá sempre o mesmo livro. Como o HTML de uma página web, a cópia mostra as páginas sem o raciocínio por trás delas. Um quadro posicionado a olho fica nas suas coordenadas, um título empurrado para baixo com um parágrafo vazio mantém o parágrafo vazio e um ajuste local continua sendo um ajuste local. O livro se parece com o original e carrega o ofício dele.

**A skill deduz as regras.** Um agente lê o original inteiro: o `.idml`, o PDF de impressão, as fontes e as ilustrações. Ele mede as páginas e anota as regras que elas seguem, como o formato e as margens, a grade de linhas de base, as funções tipográficas, as aberturas, os cabeços, as famílias de boxes e o lugar dos flutuantes. Depois grava o texto como Markdown que volta a correr e não leva posições de página, e define o design na configuração a partir dessas regras. O Postext diagrama as páginas a partir das regras, então o livro pode ser editado, traduzido e composto em outro formato, e continua parecido com o original.

|  | Importador | Skill para agentes |
| --- | --- | --- |
| Lê | O `.idml` e as imagens vinculadas dele | O `.idml`, o PDF de impressão, as fontes e as ilustrações vinculadas (`.ai`, `.psd`, `.eps`, `.tif`) |
| Método | Determinístico: copia o que o documento contém | Inferência: mede as páginas e deduz as regras |
| Texto | Preso aos quadros do documento (`--layout pages`) ou corrido com os estilos dele (`--layout flow`) | Markdown que volta a correr, com diretivas e sem posições de página |
| Design | Os valores dos estilos e dos quadros do documento | Uma configuração de regras: grade, funções tipográficas, aberturas, cabeços, boxes, flutuantes, modelos de página para páginas compostas |
| Tempo | Segundos | Horas para um livro, com um agente e verificações contra o PDF |
| Resultado | Uma réplica, com um relatório do que se perdeu | Um livro do Postext que se comporta como o original |

**Use a skill por padrão.** É o caminho certo para qualquer livro que você vai manter: um livro que vai revisar, traduzir, compor em outro formato ou publicar em EPUB além do impresso.

**Use o importador** quando o objetivo é uma cópia:

- **Um livro que o Postext exportou.** Um `.idml` gravado pelo Postext volta com as mesmas linhas e as mesmas páginas, então as alterações que um designer fizer no InDesign voltam para o livro.
- **Uma olhada rápida.** O relatório de importação lista em segundos as páginas, as matérias, os estilos, as fontes, as imagens e as tabelas do documento, antes de você decidir qualquer coisa.
- **Uma página fixa que fica como está.** Um cartaz, um formulário, uma única página dupla ou um folheto curto que não vai ser editado nem recomposto.
- **O primeiro passo de uma conversão.** A própria skill pode rodar o importador para obter um inventário e um primeiro rascunho, e depois corrigi-lo; veja [mais abaixo](https://postext.dev/pt/docs/indesign.md#como-a-skill-usa-o-importador).

## O importador

```bash
postext import-idml book.idml -o book/
postext import-idml book.idml -o book.postext --layout flow --links Links/
postext import-idml book.idml --report --json
postext import-idml package.zip -o book.postext
```

A mesma importação roda no Sandbox, em **Livros › Novo › Livro novo a partir de um documento do InDesign (IDML)** (veja [Importar um documento do InDesign](https://postext.dev/pt/docs/indesign.md#importar-um-documento-do-indesign)), que também abre um pacote do InDesign compactado em **Livro novo a partir de um pacote do InDesign (.zip)** e tira dele as fontes e as imagens vinculadas, e em código com `idmlToPostext`, do pacote `postext-idml` (veja [Uso programático › Pacotes do InDesign](https://postext.dev/pt/docs/configuration-programmatic-usage.md#pacotes-do-indesign-postext-idml)). Todas as opções do comando estão em [Linha de comando › import-idml](https://postext.dev/pt/docs/command-line.md#import-idml).

### Importar um documento do InDesign

**Livro novo a partir de um documento do InDesign (IDML)**, no menu **Novo** do painel Livros, lê um arquivo `.idml` no navegador e abre uma caixa de diálogo. Ela mostra o que o documento contém: as páginas e o tamanho delas, as matérias, as fontes que ele nomeia, as imagens, vinculadas e incorporadas, e as tabelas. **Layout** escolhe entre **Páginas compostas**, em que cada página mantém os quadros onde o documento os tem, e **Livro de texto corrido**, em que o texto corre pelas páginas que o projeto gráfico do livro faz; **Automático** deixa a escolha para o importador, que diz o motivo. Um `.idml` não leva as imagens que vincula: escolha os arquivos, ou a pasta que os contém, e cada um é associado pelo nome de arquivo. O relatório de importação acompanha cada escolha: um veredito, as contagens, o que se perdeu, foi aproximado ou anotado, cada item com uma contagem e um exemplo, as fontes de que o livro precisa e os vínculos que ainda faltam. **Criar o livro** acrescenta o resultado aos seus livros e o abre, e os livros que você tinha ficam como estavam. Um arquivo `.indd` é recusado com uma mensagem que manda salvá-lo como IDML no InDesign. A linha de comando faz a mesma importação com [`postext import-idml`](https://postext.dev/pt/docs/command-line.md#import-idml). A importação é uma cópia das páginas do documento; para um livro que você vai manter, a [skill para agentes](https://postext.dev/pt/docs/skill.md) deduz em vez disso as regras de diagramação dele (veja [A skill](https://postext.dev/pt/docs/indesign.md#a-skill)).

**Livro novo a partir de um pacote do InDesign (.zip)** recebe a pasta que **Arquivo › Empacotar** do InDesign cria, compactada em zip, com **Incluir IDML** marcado. Quando o pacote traz mais de um documento IDML, uma caixa de diálogo pergunta qual vira o livro. A caixa de diálogo de importação funciona então como acima, com o que o pacote acrescenta. As imagens vinculadas são tiradas do pacote, associadas pelo nome de arquivo e, entre arquivos de mesmo nome, pela pasta. Os arquivos de fonte de `Document fonts` entram no livro: cada estilo é associado pelo nome PostScript ao que o documento nomeia, de modo que o texto é composto nos estilos originais. O relatório lista as fontes que o pacote traz e os estilos para os quais ele não tem arquivo, e nomeia todo arquivo de fonte que o livro não pode levar (Type 1, uma maleta de fontes do Mac, um arquivo WOFF 1). Uma coleção de fontes (`.ttc`, `.otc`), como o macOS distribui fontes como a PT Sans, é separada em seus estilos: os que o texto usa, com os outros estilos das mesmas famílias, entram no livro como arquivos TrueType ou OpenType avulsos com o nome do estilo, e os demais estilos da coleção ficam de fora (desde o postext 1.83). Um pacote que traz só um `.indd` é recusado com uma mensagem que diz como obter o IDML dele.

### Páginas ou texto corrido

- **`--layout pages`** segue o documento página por página. Cada página vira uma [página composta](https://postext.dev/pt/docs/composed-pages.md) e cada quadro fica no seu lugar, com o seu tamanho e a sua ordem; uma cadeia de quadros vinculados continua sendo uma cadeia. Use-o para documentos com páginas feitas à mão uma a uma.
- **`--layout flow`** grava as matérias na ordem de leitura com os estilos de parágrafo do documento, e o Postext as compõe nas páginas que o projeto gráfico do livro faz. Use-o para texto corrido, como um romance ou um ensaio, em que as páginas só contêm o texto. As páginas cujos quadros só se leem juntos são compostas inteiras (desde o postext 1.83.1). Uma página sem texto corrido próprio, como uma capa ou uma folha de rosto de parte, vira no fluxo uma [página composta](https://postext.dev/pt/docs/composed-pages.md), com os quadros onde o InDesign os tem e as formas e imagens como decoração. Uma página cujo texto corrido começa sob um título com uma faixa, uma imagem ou um quadro preenchido é uma abertura: o título vira um título que abre a página, e o design do seu estilo de título desenha a faixa, o chapéu e a aba na margem externa, se houver. O relatório as lista como `composedPagesInFlow` e `openerDesigns`.
- **`auto`**, o padrão, escolhe um dos dois a partir do documento e diz o motivo.

### O que passa

- Os estilos de parágrafo e de caractere viram os estilos de parágrafo e de título do livro, com fonte, corpo, entrelinha, recuos, espaçamento, alinhamento, paradas de tabulação e cor.
- O texto com a sua ênfase, as quebras de linha forçadas, as tabulações, as notas de rodapé, os hiperlinks, o ruby, os sinais de ênfase e o tate-chu-yoko.
- As tabelas com as células mescladas, as linhas de cabeçalho, as margens internas e as imagens nas células; as imagens, ancoradas e posicionadas; os fios, os retângulos e as amostras de cor.
- As páginas, o tamanho e as margens delas, os itens das páginas-mestre e as seções.
- O contorno de texto. O texto contorna um quadro que o afasta. Atrás de um objeto com contorno **Saltar objeto**, o quadro de texto é cortado em quadros encadeados acima e abaixo do objeto, com os deslocamentos superior e inferior do contorno, e assim o texto para acima dele e continua abaixo, como no InDesign; **Saltar para a próxima coluna** o para acima do objeto (desde o postext 1.82.2).
- As amostras de cor especial, como cores especiais da paleta, cada uma na sua própria chapa. Uma cor especial com acabamento vira uma entrada de [`print.inks`](https://postext.dev/pt/docs/special-inks-die-cuts.md): o acabamento que uma exportação do Postext anotou volta como foi escrito, e qualquer outro é deduzido do nome da tinta (`PANTONE 871 C`, metálica; `Verniz`, um verniz) e aparece em `inkFinishGuessed` para você confirmar com a gráfica (desde o postext 1.87.0).
- A linha de faca. Os traçados de uma camada com nome de linha de faca (Faca, Die line, Troquel…), ou cujo traço usa uma amostra `CutContour`, `Die` ou `Dieline`, nas páginas ou nas páginas-mestre delas, viram os [`dieCuts`](https://postext.dev/pt/docs/special-inks-die-cuts.md) do livro: cada furo, uma forma posta no primeiro recto que corta, com `leaves` quando atravessa também as folhas seguintes, e uma borda recortada, como cantos arredondados (`corners`) ou um contorno (`outline`). O nome da amostra vira `print.dieLine.ink`. Os traçados da faca não são copiados como ilustração (desde o postext 1.87.0).

### O que o relatório informa

O `.idml` não leva as fontes nem as imagens vinculadas. O importador lista as famílias de fontes de que o livro precisa, que você depois passa para a geração com `--font-dir`. Ele lê as imagens vinculadas de `--links` ou da pasta do arquivo, e lista as que não encontra. Um pacote compactado traz as duas coisas: na linha de comando (`postext import-idml package.zip`), no Sandbox e em código com `openIdmlArchive`, o importador tira as imagens da pasta `Links` dele e coloca no livro os arquivos de fonte da pasta `Document fonts`.

O InDesign faz coisas que não têm equivalente no Postext, como texto em um traçado, uma célula girada, uma linha diagonal em uma célula, estilos GREP e aninhados ou efeitos de transparência. Cada uma delas vira um achado do relatório, com uma contagem e um exemplo: uma *perda* quando fica de fora, um *aviso* quando é composta de forma parecida com o original (as linhas de rodapé de uma tabela, um degradê, um contorno de texto). O relatório termina com um veredito:

- **`faithful`**: nada foi perdido nem aproximado. Um livro exportado do Postext volta fiel. Desde o postext 1.85.0 a exportação encadeia o texto corrido das páginas compostas em colunas numa só matéria, um quadro por coluna, e o importador o lê de volta como o livro de fluxo que era: os parágrafos inteiros, os títulos, as caixas e as figuras com suas legendas onde estavam. Suas guias de coluna são as colunas da página, coluna lateral incluída. Desde o postext 1.86.0 seus cabeçalhos e números de página voltam como o cabeçalho e o rodapé do livro, inclusive os das aberturas de capítulo, e as caixas flutuadas numa coluna lateral (glosas) voltam como flutuantes dessa coluna. As formas que o Postext desenha em cada página ficam de fora e são relatadas como perda (`pageArtInFlow`), então um livro que as tem volta `lossy` como livro de fluxo; seu design pode desenhá-las de novo. Exportado com `--text frames` (um quadro por bloco, como antes da 1.85.0), volta como páginas compostas, cada página com seus quadros onde a exportação os pôs, e os estilos de parágrafo, os estilos de caractere, as caixas e as imagens do livro (desde o postext 1.84.0).
- **`approximate`**: algumas coisas foram compostas de forma parecida com o original, e nada ficou de fora.
- **`lossy`**: alguma coisa ficou de fora.

### Quanto a cópia se parece

O IDML guarda o texto e os quadros, não as linhas em que o InDesign os quebrou. O Postext quebra as linhas de novo com o seu próprio compositor, então uma linha de um documento feito no InDesign raramente termina na mesma palavra. O que deve coincidir é qual texto cai em qual página. O importador é testado com um corpus de documentos feitos no InDesign: um livro de 15 páginas, páginas de revista, tabelas, links e notas, japonês e árabe, objetos ancorados e estilos. Nos seis que foram medidos, de 87 a 100 por cento das palavras caem na mesma página que no PDF do próprio InDesign (desde o postext 1.78).

Um livro que o Postext exportou mantém as suas linhas. Cada linha da exportação termina com uma quebra forçada, e o importador ativa [`bodyText.justifyHardBreaks`](https://postext.dev/pt/docs/configuration-text.md) para que essas linhas continuem justificadas.

## A skill

A [skill para agentes](https://postext.dev/pt/docs/skill.md) porta um livro nos passos que aquela página descreve: um briefing, um inventário do original, uma folha de dados medidos, a configuração, os capítulos e a verificação de cada página contra o original. Para um livro do InDesign, dê a ela tudo o que o InDesign tem.

### A pasta do original

No InDesign, **Arquivo › Empacotar** reúne as fontes e as imagens vinculadas do documento em uma pasta; marque **Include IDML** e **Include PDF (Print)**. Ponha essa pasta no projeto como `source/`:

```
my-book/
  source/
    Book.indd
    Book.idml
    Book.pdf
    Document fonts/
    Links/
      cover.ai
      map-01.ai
      photo-12.psd
```

- **O `.idml`** dá o texto, os estilos, as tabelas e as imagens ancoradas na ordem das matérias. A skill o lê com o seu próprio `idml_extract.py`, que atribui uma função a cada estilo de parágrafo.
- **O PDF de impressão** dá o que falta ao `.idml`: onde cada linha, cada boxe e cada figura caiu na página impressa. A skill mede nele a grade, as margens e as aberturas, e no fim compara as próprias páginas com ele.
- **As fontes** permitem ao Postext compor o texto nas letras do original, para que as medidas se mantenham. Verifique se a licença delas permite isso; a skill pergunta quando não consegue saber.
- **As ilustrações** de `Links/` viram as figuras do livro: os arquivos do Illustrator como SVG vetorial, e os do Photoshop e TIFF como bitmaps.

Depois peça ao agente, por exemplo: *“Porte para o Postext o livro do InDesign que está em `source/`: primeiro os capítulos 1 a 3, em espanhol, para impressão e EPUB.”*

### Como a skill usa o importador

A skill pode rodar `postext import-idml source/Book.idml --report --json` no início. O relatório dá um inventário em segundos: os estilos em uso, as matérias, as fontes, as imagens, as tabelas e o que não tem equivalente. A skill parte dele, e não entrega a importação como está. Ela substitui os quadros em lugares fixos por regras e modelos, os parágrafos vazios e os ajustes locais por espaçamentos e estilos, e as posições de cada página por flutuantes.

## O exportador

```bash
postext idml book/ -o book.idml
postext idml book.postext -o book.idml --images link --fonts
postext build book/ --pdf book.pdf --idml book.idml
```

O exportador diagrama o livro como o PDF faz e grava as páginas como um `.idml` para um designer finalizar no InDesign. Ele roda pela linha de comando ([`postext idml`](https://postext.dev/pt/docs/command-line.md#idml), ou `--idml` em `build`), pelo Sandbox (**Exportar para o InDesign (IDML)** no cabeçalho do painel Texto; veja [Sandbox › Livros e salvamento](https://postext.dev/pt/docs/sandbox-books-saving.md)) e em código com `idmlDocument`, de `postext-idml`.

- **Páginas e lâminas.** As páginas ficam no formato refilado, em lâminas de páginas espelhadas em um livro com margens espelhadas e uma página por lâmina nos outros casos; `--spreads facing` ou `--spreads single` as monta assim, digam as margens o que disserem.
- **Linhas.** `--lines keep`, o padrão, termina cada linha onde o Postext a terminou, então o InDesign mostra as mesmas linhas do PDF. `--lines reflow` deixa os parágrafos para o compositor do InDesign, no caso de um livro que vai ser composto de novo lá.
- **Texto.** O texto corrido das páginas compostas em colunas corre numa só matéria, encadeada por um quadro de texto por coluna, como num livro diagramado no InDesign, e as caixas do fluxo ficam ancoradas nela (desde o postext 1.85.0); `--text frames` escreve em vez disso um quadro e uma matéria por bloco, onde o Postext o pintou. Cada bloco de uma página composta vira um quadro de texto com a sua própria matéria, e os blocos encadeados com `next` compartilham uma. Os estilos de parágrafo levam os nomes dos estilos do livro, os recuos, as paradas de tabulação e o espaçamento. Passam as notas de rodapé, os links, o ruby, os sinais de ênfase e as matérias da direita para a esquerda e verticais.
- **Cabeçalhos.** Com o texto encadeado, os cabeçalhos e os números de página ficam em páginas-mestre, como num livro composto no InDesign (desde o postext 1.86.0). O número de página é o número de página atual do InDesign, `{chapterTitle}` é uma variável de texto de cabeçalho que mostra o último título de capítulo da página, e as outras palavras são escritas como estão. As páginas que mostram os mesmos cabeçalhos aplicam a mesma página-mestre, e as aberturas de capítulo têm uma própria, chamada Opener. Um cabeçalho que o InDesign não consegue expressar, como `{attr.lugar}`, fica na sua página. As caixas flutuadas numa coluna lateral (glosas) são ancoradas no texto corrido numa posição personalizada, de modo que acompanham o parágrafo ao lado do qual estão.
- **Itens de página.** Fios, boxes, traçados e imagens viram itens de página do InDesign; as tabelas viram tabelas do InDesign, e as fórmulas em linha, a música e as amostras viram objetos ancorados. As cores CMYK definidas pelo autor viram amostras de cor de escala, e os chips com campo de formulário viram campos de formulário do InDesign.
- **Tintas especiais e linha de faca.** Cada cor especial vira uma amostra de cor especial com tinta própria, e o acabamento fica no rótulo de script da amostra (`postext:finish`), porque o InDesign não tem um campo para ele. O Gerenciador de tintas recebe o tipo de tinta com que o acabamento se separa: Transparente para um verniz, Opaca para um branco, uma tinta metálica ou um hot stamping. O branco e o verniz sobreimprimem, como no PDF. As facas especiais são desenhadas numa camada bloqueada chamada **Die line**, como traçados cujo traço usa a amostra da faca, em sobreimpressão; a camada não imprime quando `print.dieLine.output` é `none`. Importado de novo, o pacote devolve as mesmas tintas e as mesmas facas especiais (desde o postext 1.87.0).
- **Imagens e fontes.** `--images link` grava as imagens em `Links/`, ao lado do pacote, em vez de incorporá-las. Cada arquivo leva a extensão do seu formato (`.svg`, `.png`, `.jpg`, `.pdf`…), então abre no seu programa depois de descompactado. `--fonts` grava os arquivos de fonte em `Document fonts/`, onde o InDesign os encontra, e deixa de fora qualquer família que o livro não possa redistribuir.
- **Avisos.** O que o InDesign não consegue mostrar como o Postext compôs é avisado como `idml.*`, como a moldura arredondada de uma tabela ou os pontos de ênfase do texto vertical.

Exportar não é portar ao contrário. O `.idml` contém as páginas que o Postext diagramou, e as regras que as diagramaram ficam no livro do Postext. Uma alteração feita no InDesign volta ao Postext pelo importador, como cópia da página. As regras que você quiser mudar, como o corpo de letra, é melhor mudar no livro do Postext e exportar de novo.

## Em resumo, qual escolher

- **Para manter, editar ou traduzir um livro feito no InDesign**, porte-o com a skill a partir de uma pasta empacotada.
- **Para ver o que um `.idml` contém**, ou para trazer de volta um livro que o Postext exportou, use o importador.
- **Para manter como está uma página fixa avulsa**, importe-a com `--layout pages`.
- **Para mandar um livro do Postext para um estúdio que trabalha com InDesign**, exporte-o com `postext idml`.
