从FrameMaker到结构化写作：技术文档工具的两条路

最近跟几位做技术文档的朋友聊天，发现一个有意思的现象：好几家用了多年FrameMaker的企业，最近都在看新的工具。不是说FrameMaker不好，而是业务场景变了，需求侧重点不一样了。

正好我自己也在做工具选型调研，把两家的情况客观梳理一下，供同行参考。

FrameMaker：老牌强者的底子

先说FrameMaker。这名字在技术文档圈子里分量不轻，航空、军工行业的首选工具。

它的优势很硬核：

排版质量确实是工业级。印刷品质的输出，几百页的复杂文档稳定性极好，崩溃风险低。这点行业内公认。

结构化成熟度高。XML/DITA支持完善，语义标记能力强。如果走严格的结构化文档路线，FM是标杆。

生态积累深厚。几十年下来，插件、模板、培训资源、社区支持都很成熟。遇到问题基本能找到解决方案。

但也有一些现实问题：

学习曲线太陡。新人上手基本要两周培训，第一周在崩溃边缘。对于人员流动大的团队，这个成本不能忽视。

协作能力弱。本质上还是单机软件。团队多人写一本手册，要么等上一个人改完，要么手动合并文件。版本冲突、覆盖丢失，做文档的应该都经历过。

价格不算低。月费40多美元起步，长期使用成本不低。

架构有些年头了。界面风格多年没什么变化，对中文的支持也有些历史遗留问题。

Xmanual：另一种思路

再说Xmanual。Xmanual定位是结构化技术写作和内容管理系统。名气不如FM大，但思路值得关注。

几个特点：

上手门槛低。界面和操作逻辑接近Word，新员工半天就能开始干活。不用专门搞两周培训。对于需要快速上手的团队，这个差异很明显。

在线协作是核心能力。支持多人同时编辑同一本手册的不同章节，互不干扰。文档主管只需要审核内容，不用手动合并文件。这在FM上是做不到的。

内容重用是真“引用”。把文档拆成独立主题，多本手册可以引用同一份内容。改一次，所有地方同步更新。不用人工检查“这个参数有没有漏改”。

多语言管理一体化。一个主题下面直接切换语言版本，中文改了参数，切换到英文版自己就能改。图片也支持多语言版本，不用重新出图。不再需要发邮件给翻译、等排期、手动替换。

发布很省事。PDF、HTML5、Word、Markdown一键输出。可以搭在线帮助中心，海外用户自己搜答案。

两者怎么选

客观说，两条路对应不同场景。

还在用FrameMaker的情况：

• 客户强制要求FM格式（某些航空、军工项目）

• 需要印刷级排版质量

• 文档主要是单人编写，协作需求不强

可以考虑Xmanual的情况：

• 团队多人协作频繁，文件传来传去效率低

• 新员工上手慢，培训成本高

• 产品出口多国，多语言版本管理麻烦

• 需要输出多种格式，不想每次都手工排版

• 希望内容能复用，不想反复复制粘贴

一点观察

技术文档工具这个领域，FrameMaker代表的是“排版驱动”的经典路线——追求极致的印刷质量和结构化严谨性。Xmanual代表的是“内容驱动”的新思路——强调内容复用、团队协作、多格式发布。

两者不是谁替代谁的关系。对于排版要求极高的场景，FM依然是标杆。但如果核心痛点是协作效率、内容复用、多语言管理，Xmanual提供了一种更轻量、更现代化的选择。

工具选型没有标准答案，看自己的业务场景和团队情况。以上信息供参考。