CML是严格基于XML语法规范构建的专用领域标记语言，专为精确表达化学信息而设计；它定义化学语义明确的标签体系，需通过Schema校验才能确保化学合法性，支持多维化学数据的结构化存储与FAIR管理。

CML（Chemical Markup Language）不是“XML的一种变体”，而是**严格基于XML语法规范构建的专用领域标记语言**，专为精确表达化学信息而设计。它不改变XML规则，但定义了一套化学语义明确的标签体系——这意味着任何标准XML解析器都能读取CML文件，但只有理解CML Schema的工具（如Jmol、JChemPaint、或用lxml配合cml.xsd校验的Python脚本）才能正确解释“哪个<atom></atom>是氧”、“order="2"代表双键”。

怎么写一个合法的CML分子结构？

核心是三要素：一个<molecule></molecule>容器、若干<atom></atom>声明原子、一组<bond></bond>描述连接关系。所有原子必须有id，键通过atomRefs2引用两个原子ID。

<molecule id="ethanol">
  <atom id="a1" elementType="C" x3="0.0" y3="0.0" z3="0.0"/>
  <atom id="a2" elementType="C" x3="1.5" y3="0.0" z3="0.0"/>
  <atom id="a3" elementType="O" x3="2.5" y3="0.0" z3="0.0"/>
  <bond atomRefs2="a1 a2" order="1"/>
  <bond atomRefs2="a2 a3" order="1"/>
</molecule>

• elementType必须是标准元素符号（如"C"、"O"），不能写"carbon"或小写"c"
• x3/y3/z3是可选的三维坐标；若省略，只靠<bondarray></bondarray>也能表示拓扑结构（即连接性），但失去几何信息
• 没有<atom></atom>定义却在atomRefs2里引用——XML解析会成功，但化学工具通常报“undefined atom reference”错误

为什么不用SMILES而选CML？

SMILES是紧凑字符串，适合数据库索引和快速比对；CML是结构化文档，适合承载多维化学数据。当你需要同时存下：分子结构 + NMR位移表 + 晶体空间群 + 反应条件注释 + 实验者签名——SMILES做不到，而CML用嵌套标签天然支持。

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• SMILES无法表达立体化学细节（如R/S构型）或部分氢缺失的金属配合物；CML用formalCharge、spinMultiplicity、isotopeNumber等属性直接建模
• CML可内嵌<scalar></scalar>或<array></array>存光谱数据，甚至用<metadata></metadata>加DC元数据（如dc:creator）
• 浏览器直接打开CML文件不会渲染分子——它不是HTML；需配合XSLT转换或用JSmol等JS库解析后绘图

常见解析失败原因和对策

用Python的xml.etree.ElementTree能加载CML，但容易漏掉关键约束。真正校验是否“化学合法”，得靠Schema。

• 忘记声明命名空间：xmlns="http://www.xml-cml.org/schema"必须出现在<molecule></molecule>或根节点，否则<atom></atom>会被当成无意义自定义标签
• 用lxml时未加载cml.xsd校验，导致elementType="Xx"这种非法元素名被静默接受
• 某些老工具（如旧版MarvinSketch）导出的CML含convention="cmlDict"等过时属性，新解析器可能忽略或报错
• 中文路径或含空格的文件名传给Java系工具（如Jmol）时，常因URL编码问题加载失败——改用绝对路径+URL编码（file:///home/user/%E6%B0%B4.cml）

CML的价值不在“能不能表示水分子”，而在于它把化学家脑中的多维事实（结构、数据、上下文）映射成机器可验证、可组合、可溯源的XML文档——这点在自动化反应记录、FAIR科研数据管理中不可替代。别把它当“带标签的SMILES”，它本质是化学世界的XML schema。