# InDesign：导入、导出与移植

> 把InDesign书籍带进Postext的两种方式：照搬文档内容的IDML导入器，和推断版式规则的智能体技能；各自适合什么情况，以及IDML导出器怎样把书交回InDesign

- HTML版本: https://postext.dev/zh/docs/indesign
- 最后更新: 2026-11-14
- 阅读时间: 8分钟
- 其他语言: [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), [pt](https://postext.dev/pt/docs/indesign.md), [ja](https://postext.dev/ja/docs/indesign.md), [ar](https://postext.dev/ar/docs/indesign.md)

## 简单来说

用InDesign做的书可以用两种方式带进Postext。导入器照搬InDesign文件里的内容，每一页、每个框和每种样式都原样保留，速度很快，但得到的是旧页面的副本，不好修改，也不好翻译。智能体技能则研究这本书：文件、印刷PDF、字体和图片，找出设计者遵循的规则，再按这些规则重建这本书，文字可以自由排下去。这样得到的书更好，所以我们推荐这种方式。本页说明这两种方式、各自适合的情况，以及Postext怎样把做好的书交回InDesign。

**InDesign做的书进入Postext，可以照搬它的页面，也可以推断它的设计。我们推荐推断设计。**

Postext读写InDesign Markup包（`.idml`），也就是InDesign用**文件 › 存储为 › InDesign Markup (IDML)**保存的文件。有三个工具用到它：

- **导入器**，把`.idml`变成一本Postext书；
- **智能体技能**[`postext-port`](https://postext.dev/zh/docs/skill.md)，根据一本书的全部源文件（包括`.idml`）移植这本书；
- **导出器**，把Postext书写成`.idml`，交给设计者在InDesign中完成。

导入器和技能都能把书带进来，但得到的不是同一本书。本页说明两者的区别，方便你选择。

> [InDesign，进得来，出得去：用 Postext 导入、移植和导出 InDesign 书](https://youtu.be/ZaV91XYhKp0) · 4:21

## 进入Postext的两种方式

InDesign文档是一组由人手工做出的页面。设计者遵循一些规则，比如字号、网格、一章怎样开头、方框放在哪里、图注怎样放在图下面。`.idml`逐个框地保存应用这些规则的结果，并不记录规则本身。

**导入器照搬结果。**它读取这个包，把找到的东西写出来：每个框留在原来的位置，每种样式带着它的值，每张图片和每个表格成为一个资源。它不做任何推测，同一个文件总是得到同一本书。就像网页的HTML一样，这份副本展示页面，却不展示页面背后的道理。凭眼睛摆放的框留在它的坐标上，用空段落往下推的标题保留那个空段落，局部覆盖仍是覆盖。这本书看起来和原书一样，也保留了原书的手工做法。

**技能推断规则。**智能体读取全部源文件：`.idml`、印刷PDF、字体和美术文件。它测量页面，写下页面遵循的规则，比如成品尺寸和页边距、基线网格、字体角色、章首页、书眉、标注框类别以及浮动对象放在哪里。然后它把文字写成不带页面位置的可重排Markdown，并依据这些规则在配置中设定设计。Postext按规则排出页面，所以这本书可以修改、翻译，也可以换一种开本来排，看起来仍然和原书一样。

|  | 导入器 | 智能体技能 |
| --- | --- | --- |
| 读取 | `.idml`及其链接的图片 | `.idml`、印刷PDF、字体和链接的美术文件（`.ai`、`.psd`、`.eps`、`.tif`） |
| 方法 | 确定性的：照搬文档的内容 | 推断：测量页面，找出规则 |
| 文字 | 绑定在文档的框里（`--layout pages`），或沿用文档的样式连续排下去（`--layout flow`） | 带指令的可重排Markdown，不带页面位置 |
| 设计 | 文档中样式和框的值 | 一套规则配置：网格、字体角色、章首页、书眉、标注框、浮动对象，以及模板页的页面模板 |
| 时间 | 几秒 | 一本书要几个小时，由智能体完成，并对照PDF检查 |
| 结果 | 一份复制品，附上丢失内容的报告 | 一本表现和原书一样的Postext书 |

**默认使用技能。**任何你要长期保留的书都应该走这条路：要修订、要翻译、要换开本，或者除了印刷还要出EPUB的书。

需要的就是副本时，**使用导入器**：

- **Postext导出的书。**Postext写出的`.idml`读回来时行和页都不变，所以设计者在InDesign中的修改能回到书里。
- **快速看一眼。**导入报告几秒钟就列出文档的页面、文章、样式、字体、图片和表格，让你在做任何决定之前先了解它。
- **原样保留的固定页面。**海报、表格、单个跨页或者一本短小的宣传册，不会再修改，也不会重排。
- **移植的第一步。**技能本身可以先运行导入器，得到清单和初稿，再加以修正；见[下文](https://postext.dev/zh/docs/indesign.md#技能怎样使用导入器)。

## 导入器

```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
```

同样的导入也可以在Sandbox中进行，位置是**书库 › 新建 › 从 InDesign 文档（IDML）新建书**（见[导入InDesign文档](https://postext.dev/zh/docs/indesign.md#导入indesign文档)；沙盒还能用**从 InDesign 打包文件（.zip）新建书**打开压缩成zip的InDesign打包文件，并从中取用字体和链接的图片），在代码中则用`postext-idml`包的`idmlToPostext`（见[以编程方式使用 › InDesign包](https://postext.dev/zh/docs/configuration-programmatic-usage.md#indesign包postext-idml)）。命令的全部选项见[命令行 › import-idml](https://postext.dev/zh/docs/command-line.md#import-idml)。

### 导入InDesign文档

**书库**面板**新建**菜单中的**从 InDesign 文档（IDML）新建书**在浏览器中读取一个`.idml`文件，并打开一个对话框。对话框列出文档的内容：页数和页面大小、文章、用到的字体、链接的和嵌入的图片，以及表。**排版方式**有两种：**模板页**让每一页的框架都留在文档中原来的位置，**流式排版的书**让文字顺着书的设计生成的页面排下去；**自动**把选择交给导入器，导入器会说明理由。`.idml`不带它所链接的图片：请选择这些文件，或选择它们所在的文件夹，每张图片按文件名匹配。导入报告随每一项选择更新：结论、各项计数，丢失、近似和备注三类情况（每类附数量和一个例子），这本书需要的字体，以及仍缺少的链接。**创建这本书**把结果加入你的书并打开它，原有的书保持不变。`.indd`文件会被拒绝，提示会说明要先在InDesign中把它存为IDML。命令行用[`postext import-idml`](https://postext.dev/zh/docs/command-line.md#import-idml)做同样的导入。导入得到的是文档页面的副本；对于你会长期保留的书，[智能体技能](https://postext.dev/zh/docs/skill.md)会推断出它的版式规则（见[技能](https://postext.dev/zh/docs/indesign.md#技能)）。

**从 InDesign 打包文件（.zip）新建书**读取InDesign的**文件 › 打包**生成的文件夹，打包时须勾选**包括 IDML**，再压缩成zip。打包文件中有不止一个IDML文档时，会弹出对话框询问哪一个成为这本书。之后的导入对话框与上面所述相同，另外列出打包文件带来的内容。链接的图片取自打包文件，按文件名匹配；同名的文件再按文件夹区分。`Document fonts`中的字体文件放入书中：每种字体样式按PostScript名称与文档指定的字体样式匹配，因此文字用原来的字体样式排出。报告列出打包文件带有的字体和没有对应文件的字体样式，并指出书无法带上的字体文件（Type 1、Mac字体手提箱、WOFF 1文件）。字体集（`.ttc`、`.otc`，macOS就是这样提供PT Sans等字体的）会拆成单个字体样式：正文用到的样式，连同同一字族的其他样式，以按样式命名的单独TrueType或OpenType文件放进书中，字体集里的其他样式不带入（自postext 1.83起）。只含一个`.indd`的打包文件会被拒绝，提示会说明如何得到它的IDML。

### 逐页还是连续排

- **`--layout pages`**逐页照文档排。每一页成为一个[模板页](https://postext.dev/zh/docs/composed-pages.md)，每个框保持原来的位置、大小和顺序，串接的框仍然串接。适合每一页都是手工做出来的文档。
- **`--layout flow`**按阅读顺序写出各篇文章，沿用文档的段落样式，由Postext把它们排进书的设计生成的页面。适合小说、随笔这类连续的文字，页面只是用来容纳文字。各个框只有放在一起才读得通的页面会整页排出（自postext 1.83.1起）。没有自己正文的页面，如封面或篇章页，在连续版式中成为一个[组合页面](https://postext.dev/zh/docs/composed-pages.md)，各框留在InDesign中的位置，形状和图片作为装饰。正文从一个带色带、图片或填色框的标题下面开始的页面是章首页：标题成为开启该页的标题，其标题样式的设计画出色带、眉题和切口上的书签。报告把它们列为`composedPagesInFlow`和`openerDesigns`。
- **`auto`**是默认值，它根据文档选一种，并说明理由。

### 带过来的内容

- 段落样式和字符样式成为书的段落样式和标题样式，连同字体、字号、行距、缩进、间距、对齐、制表位和颜色。
- 文字连同强调、强制换行、制表符、脚注、超链接、注音、着重号和纵中横。
- 表格连同合并单元格、表头行、内边距和单元格中的图片；锚定和置入的图片；线条、矩形和色板。
- 页面及其尺寸和页边距、主页上的项目，以及章节。
- 文本绕排。文本绕开设置了绕排的框。在绕排方式为**上下型绕排**的对象后面，文本框被切成对象上方和下方相互串接的框，并保留绕排的上、下位移，文本因此像在InDesign中一样在对象上方停下、在下方继续；**下一栏绕排**则让文本停在对象上方（自postext 1.82.2起）。
- 专色色板，作为调色板中的专色，各自印在单独的印版上。带工艺的专色成为[`print.inks`](https://postext.dev/zh/docs/special-inks-die-cuts.md)中的一项：Postext导出时记下的工艺原样读回，其他的按油墨名称推断（`PANTONE 871 C`为金属油墨，`光油`为上光油），并列在`inkFinishGuessed`下，请与印厂核实（自postext 1.87.0起）。
- 模切线。名称像模切线的图层（模切、Die line、Troquel…）上的路径，或描边为`CutContour`、`Die`、`Dieline`色板的路径，无论在页面上还是在主页上，都成为书的[`dieCuts`](https://postext.dev/zh/docs/special-inks-die-cuts.md)：每个孔是一个形状，放在它切到的第一个奇数页上，若还穿过后面的纸页则带`leaves`；裁切的边缘成为圆角（`corners`）或轮廓（`outline`）。色板的名称成为`print.dieLine.ink`。模切路径不作为图稿复制（自postext 1.87.0起）。

### 报告的内容

`.idml`不带字体，也不带链接的图片。导入器列出这本书需要的字体家族，你再用`--font-dir`把它们交给构建。链接的图片从`--links`或文件旁边读取，找不到的会列出来。压缩成zip的打包文件两样都带：在命令行中（`postext import-idml package.zip`）、在沙盒中，以及在代码中用`openIdmlArchive`时，导入器从其`Links`文件夹取用图片，并把其`Document fonts`文件夹中的字体文件放入书中。

InDesign能做的有些事在Postext中没有对应，比如路径文字、旋转的单元格、单元格中的对角线、GREP样式和嵌套样式，或者透明效果。每一项都成为报告中的一条结果，附带数量和一个例子：省略的是*loss*，以接近原稿的方式排出的是*warning*（表格的表尾行、渐变、沿轮廓绕排）。报告最后给出结论：

- **`faithful`**：没有丢失，也没有近似处理。Postext导出的书会忠实返回。自postext 1.85.0起，导出把分栏排版页面的正文串接成一篇文章，每栏一个框，导入器把它读回原来的连续版式的书：段落完整，标题、方框以及带图注的插图都在原来的位置。栏参考线就是页面的栏，侧栏也包括在内。自postext 1.86.0起，书眉和页码作为书的页眉和页脚返回，章首页自己的也包括在内；浮动到侧栏的方框（旁注）作为该栏的浮动对象返回。Postext在每页绘制的图形不会导入，并作为丢失列入报告（`pageArtInFlow`），因此带有图形的书以连续版式返回时结论为`lossy`，可由它的设计重新绘制。用`--text frames`导出（每个块一个框，与1.85.0之前相同）时，它以组合页面的形式返回：每页的框都在导出时放置的位置，书的段落样式、字符样式、方框和图片也都保留（自postext 1.84.0起）。
- **`approximate`**：有些内容以接近原稿的方式排出，没有省略任何内容。
- **`lossy`**：有内容被省略。

### 副本有多接近

IDML保存的是文字和框，不是InDesign断出的行。Postext用自己的排版器重新断行，所以InDesign做的文档里，一行很少会在同一个词上结束。应该一致的是哪段文字落在哪一页。导入器用一组在InDesign中制作的文档做过测试：一本15页的书、杂志页面、表格、链接和注释、日文和阿拉伯文、锚定对象和样式。在测量过的其中六份文档中，87%到100%的词落在与InDesign自己的PDF相同的页上（自postext 1.78起）。

Postext导出的书保留它的行。导出的每一行都以强制换行结束，导入器会开启[`bodyText.justifyHardBreaks`](https://postext.dev/zh/docs/configuration-text.md)，让这些行保持两端对齐。

## 技能

[智能体技能](https://postext.dev/zh/docs/skill.md)按那一页说明的步骤移植一本书：需求、源文件清单、一份实测数据的规格表、配置、各章，以及把每一页和原书对照检查。对于InDesign书，把InDesign有的东西都交给它。

### 源文件夹

在InDesign中，**文件 › 打包**会把文档的字体和链接的图片收进一个文件夹；勾选**包括 IDML**和**包括 PDF（打印）**。把这个文件夹作为`source/`放进项目：

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

- **`.idml`**按文章顺序给出文字、样式、表格和锚定的图片。技能用它自带的`idml_extract.py`读取，把每种段落样式对应到一个角色。
- **印刷PDF**给出`.idml`缺少的东西：每一行、每个方框、每幅图落在印刷页面的什么位置。技能在这里测量网格、页边距和章首页，最后也拿自己的页面和它比较。
- **字体**让Postext用原书的字体排文字，测量结果才站得住。请确认字体许可允许这样做；技能无法判断时会问你。
- `Links/`中的**美术文件**成为书中的图：Illustrator文件成为矢量SVG，Photoshop和TIFF文件成为位图。

然后向智能体提出要求，例如：*“把`source/`里的InDesign书移植到Postext：先做第1到3章，西班牙语，用于印刷和EPUB。”*

### 技能怎样使用导入器

技能可以一开始就运行`postext import-idml source/Book.idml --report --json`。报告几秒钟就给出清单：用到的样式、文章、字体、图片、表格，以及没有对应的内容。技能从这份清单出发，但不会把导入的结果直接交付。它把固定位置上的框换成规则和模板，把空段落和覆盖换成间距和样式，把每页的位置换成浮动对象。

## 导出器

```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
```

导出器像排PDF那样给书排版，再把页面写成`.idml`，交给设计者在InDesign中完成。它可以从命令行运行（[`postext idml`](https://postext.dev/zh/docs/command-line.md#idml)，或`build`中的`--idml`），从Sandbox运行（正文面板标题栏中的**导出到 InDesign**（IDML）；见[沙盒 › 书、Word文件与保存](https://postext.dev/zh/docs/sandbox-books-saving.md)），也可以在代码中用`postext-idml`的`idmlDocument`。

- **页面与跨页。**页面按成品尺寸放置：设了对称页边距的书排成对页的跨页，否则每个跨页一页；`--spreads facing`或`--spreads single`不管页边距怎样设，都按指定的方式排。
- **行。**默认的`--lines keep`让每一行都在Postext断行的位置结束，因此InDesign显示的行与PDF相同。`--lines reflow`把段落交给InDesign的排版器，用于要在InDesign中重新排版的书。
- **文字。**分栏排版页面的正文是一篇文章，像在InDesign中排的书一样，串接在每栏一个的文本框中，流中的方框锚定在其中（自postext 1.85.0起）；`--text frames`则在Postext绘制的位置为每个块写一个框和一篇文章。模板页的每个框成为一个带有独立文章的文本框，用`next`串接的框共用一篇文章。段落样式带有书中的样式名、缩进、制表位和间距。脚注、链接、注音、着重号、从右到左的文章和竖排文章都会带过去。
- **书眉。**正文串接导出时，书眉和页码放在主页上，与在InDesign中排版的书一样（自postext 1.86.0起）。页码是InDesign的当前页码，`{chapterTitle}`是显示该页最后一个章标题的书眉文本变量，其他文字照原样写出。显示相同书眉的页面应用同一个主页，章首页有自己的主页，名为Opener。InDesign无法表达的书眉（例如`{attr.place}`）留在所在页面上。浮动到侧栏的方框（旁注）以自定位置锚定在正文中，随旁边的段落一起移动。
- **页面项目。**线条、方框、路径和图片成为InDesign页面项目；表格成为InDesign表格，行内公式、乐谱和色样成为锚定对象。作者定义的CMYK颜色成为印刷色色板，表单域标签成为InDesign表单域。
- **特种油墨与模切线。**每种专色成为一个专色色板，带有自己的油墨；工艺记在色板的脚本标签中（`postext:finish`），因为InDesign没有存放工艺的字段。油墨管理器得到该工艺分色所用的油墨类型：上光油为透明，白墨、金属油墨和烫金为不透明。白墨和上光油设为叠印，与PDF相同。模切画在名为**Die line**的锁定图层上，路径用模切色板描边并设为叠印；`print.dieLine.output`为`none`时该图层不打印。再次导入后，这个包给回同样的油墨和模切（自postext 1.87.0起）。
- **图片与字体。**`--images link`把图片写到包旁边的`Links/`中，而不嵌入。每个文件都带有其格式的扩展名（`.svg`、`.png`、`.jpg`、`.pdf`等），解压后即可用相应的程序打开。`--fonts`把字体文件写到`Document fonts/`中，InDesign会在那里找到它们；书无权再分发的字体家族不写出。
- **警告。**InDesign无法照Postext排出的样子显示的内容，以`idml.*`警告报告，比如表格的圆角外框或竖排文字里的着重号。

导出不是反过来的移植。`.idml`保存的是Postext排出的页面，排出这些页面的规则留在Postext书里。在InDesign中做的修改，要通过导入器回到Postext，回来的是页面的副本。像字号这样的规则，最好在Postext书中修改，再重新导出。

## 简要选择

- **要保留、修改或翻译InDesign做的书**，用技能从打包好的源文件夹移植。
- **要看看一个`.idml`里有什么**，或者要把Postext导出的书读回来，用导入器。
- **要把一次性的固定页面原样保留**，用`--layout pages`导入。
- **要把Postext书交给InDesign工作室**，用`postext idml`导出。
