Oxygen XML Editor 是面向结构化内容的专业工具，关键在于验证结构、重用内容、一键发布；应使用预设模板新建文档，依赖实时校验与 conref/keyref 实现内容重用，并通过预置转换场景导出 PDF/HTML。
Oxygen XML Editor 不是“装上就能写”的轻量 工具 ，而是面向结构化内容的专业环境。用好它的关键不是记住所有菜单，而是理解三个动作： 验证结构、重用内容、一键发布。新手常卡在“不知道从哪开始编辑”，其实只要选对文档类型（比如 DITA 主题或 DocBook 章节），系统就会自动加载对应模板和校验规则。
DITA 或 DocBook 新建文档，别从空白 XML 开始
直接新建一个 .xml 文件容易漏掉必需的命名空间、DOCTYPE 或 schema 关联，导致后续无法验证或转换。正确做法是：
- 点击 File → New → Framework Templates，选择 DITA Topic、DITA Map、DocBook Article 等预设模板
- 模板会自动生成合法根元素、命名空间声明和 xsi:schemaLocation 属性
- 保存时建议用 .dita（非 .xml）后缀，Oxygen 会据此启用 DITA 特有功能，如内容重用视图、地图导航等
边写边验证，错误提示就在行尾
Oxygen 默认开启实时校验，不需要手动运行“Validate”命令。只要文档关联了 XSD、DTD 或 Relax NG 模式，输入错误标签或缺失必填属性，行号右侧立刻出现红色波浪线，悬停即可看到具体报错。
- 常见误操作：在 DITA 主题里直接写
而不是
，或漏掉
元素（DITA 严格模式下为必填） - 快速修复：光标停在报错行，按 Ctrl+1（Windows）或 Cmd+1（macOS），Oxygen 会列出可选修复项，比如自动补全缺失元素或修正命名空间前缀
- 若想临时关闭校验，右键编辑区 → Validation → Disable Validation，但不建议长期关闭
内容重用不是高级功能，而是日常操作
DITA 的核心价值在于“一次编写、多处使用”，Oxygen 把这个过程做得像插入链接一样简单：
- 写文档时，把光标放在要插入重用内容的位置，按 Ctrl+Shift+R（Cmd+Shift+R），弹出“Reference Assistant”窗口
- 可搜索本地项目中的其他 DITA 主题、图像、代码块，甚至跨文件的
或 元素 - 插入后生成的是
或 ，不是复制粘贴——修改源内容，所有引用处自动同步 - 想看清当前文件被谁引用？安装“DITA Reference View”插件（Oxygen 22.0+），侧边栏即显示全部引用关系
导出 PDF/HTML 只需点一下，但样式要提前配
“Publishing”面板里一堆按钮看着复杂，其实常用路径就一条：
