IDML是InDesign用来交换文档数据的开放式格式，本质上是一个ZIP压缩包，里面全部由XML文件构成。它通过严格的标签层级来描述版面、文字、样式和资源，任何支持XML与ZIP的工具都能解析并修改它。
IDML压缩包的整体目录
把一个.idml文件后缀改成.zip并解压，会看到类似下面的结构。最外层是designmap.xml，它相当于文档的入口，记录了文档默认设置以及各子文件的引用关系。其余目录分别承载不同职能，这种拆分让大型文档的局部修改更可控。
- designmap.xml：文档主映射文件
- Stories/：存放文字内容的故事流
- Spreads/：定义跨页与页面元素坐标
- Styles/：字符样式与段落样式定义
- Resources/：字体、色板、图像等资源
这种设计把“内容”和“样式”分离，和网页开发里的结构与表现分离思想一致。例如当你要批量替换某种字体，只需改写Resources里的字体定义，不必触碰具体文本框。
designmap.xml的作用与示例
designmap.xml是解析IDML时第一个要读的文件。它用XML指向其他模块，并声明文档级别的属性，比如默认语言、版本号。下面是一段简化后的示例，展示了它如何引用样式与跨页。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="http://ns.adobe.com/IDML/1.0/desktop">
<Styles xmlns="http://ns.adobe.com/IDML/1.0/style">
<ParagraphStyle self="ParagraphStyle/Title"/>
</Styles>
<Spreads xmlns="http://ns.adobe.com/IDML/1.0/spread">
<Spread self="Spread/1">
<TextFrame self="TextFrame/1">
<Content>示例文字</Content>
</TextFrame>
</Spread>
</Spreads>
</Document>
注意所有节点都带命名空间，解析时若忽略 xmlns 会导致找不到元素。实际文件里还会用 self 属性作为唯一ID，供其他XML交叉引用，这是IDML关联各模块的核心机制。
Stories与文字流结构
Stories目录中的XML负责承载正文。一个Story代表一段连续文字流，内部用ParagraphStyleRange和CharacterStyleRange嵌套表达格式。下面的代码展示了一个带标题样式的故事片段。
<Story xmlns="http://ns.adobe.com/IDML/1.0/story" self="Story/1">
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/Title">
<CharacterStyleRange AppliedCharacterStyle="CharacterStyle/None">
<Content>第一章</Content>
</CharacterStyleRange>
</ParagraphStyleRange>
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/Body">
<CharacterStyleRange AppliedCharacterStyle="CharacterStyle/None">
<Content>这是正文内容。</Content>
</CharacterStyleRange>
</ParagraphStyleRange>
</Story>
这种嵌套让样式可以叠加：段落级控制对齐与缩进，字符级控制字体与颜色。程序抽取纯文本时，只需递归读取所有Content节点；若要保留格式，则要还原这些Range的层级。
Spreads与版面坐标
Spreads描述页面怎么排。每个Spread可以包含多个页面，TextFrame等元素通过几何属性定位。下面的示例展示了文本框的坐标与尺寸定义方式。
<Spread xmlns="http://ns.adobe.com/IDML/1.0/spread" self="Spread/1">
<Page self="Page/1" geometricBounds="0 0 842 595"/>
<TextFrame self="TextFrame/1" parentPage="Page/1"
geometricBounds="50 50 200 500">
<StoryReference Story="Story/1"/>
</TextFrame>
</Spread>
geometricBounds使用左、上、右、下四个坐标，单位是磅。StoryReference把版面里的框和内容里的Story连起来，实现“一处写内容，多处放版面”的灵活结构。修改坐标就能重排文档，而不动文字本身。
用Python快速解析IDML
借助Python标准库zipfile与xml.etree，可以不必打开InDesign就读取内容。下面脚本演示如何列出所有Story的文字。
import zipfile
import xml.etree.ElementTree as ET
ns = {'idml': 'http://ns.adobe.com/IDML/1.0/story'}
with zipfile.ZipFile('demo.idml') as z:
for name in z.namelist():
if name.startswith('Stories/') and name.endswith('.xml'):
root = ET.fromstring(z.read(name))
for content in root.findall('.//idml:Content', ns):
print(content.text)
这个例子说明：只要理解IDML的XML命名空间与目录约定，就能用任意语言写工具。相比操作InDesign COM接口，直接解析IDML更轻量，也适合服务器端批量处理。
常见误区与注意点
不少新手以为IDML是单个XML文件，其实它是包。还有人用普通文本编辑器改完直接压缩，却忘了保留META-INF与mimetype顺序，导致InDesign拒绝打开。正确做法是沿用原包结构，只改具体XML节点。
记住：IDML的XML结构是可编程的文档模型，命名空间、self ID和目录分工三者缺一不可。
掌握上述结构后，你可以做自动排版、多语言替换、内容审核等扩展，把设计文件真正纳入自动化流水线。
IDMLInDesignXML_structure修改时间：2026-08-07 13:45:20