仅用于content mathml语义层，必须嵌套在内并声明encoding属性，浏览器不渲染其内容，专供辅助工具或后端解析使用。
MathML 中 <annotation></annotation> 标签只在 content MathML 里有效
<annotation></annotation> 不是 presentation MathML 的渲染组件，它属于 content MathML 语义层，用于给公式添加机器可读的备注（比如 LaTeX 源码、计算含义、单位、作者注释等），浏览器完全不渲染它——它只是藏在 <semantics></semantics> 里供辅助工具或后端解析用。
常见错误是把它直接塞进 <math></math> 顶层，或期望它显示文字。实际必须嵌套在 <semantics></semantics> 内，且需声明 encoding 属性说明内容类型：
-
<annotation encoding="application/x-tex">x^2 + y^2 = r^2</annotation>：提供 LaTeX 备份，方便复制或转换 -
<annotation encoding="text/plain">圆的标准方程，r为半径</annotation>：供读屏器朗读或调试查看 -
<annotation encoding="application/mathml-content">...</annotation>：嵌套另一段 content MathML，做语义细化（极少见）
为什么不能用 <annotation></annotation> 做页面上的“公式注释”？
想在公式下方加一行小字说明（如“其中 α 为衰减系数”），别用 <annotation></annotation>——它不会出现在页面上。那是 presentation MathML 的活，该用 <mtext></mtext> 或普通 HTML 元素：
- 行内补充：
<mrow><mi>E</mi><mo>=</mo><mi>m</mi><msup><mi>c</mi><mn>2</mn></msup></mrow><mtext>（质能方程）</mtext> - 块级说明：在
<math display="block"></math>后紧跟<p class="formula-note">...</p>，用 CSS 控制样式和间距 - 悬停提示：用
title属性或 JS 实现 tooltip，<mi title="介电常数">ε</mi>
混淆这两类“注释”，会导致公式渲染空白、布局错乱，或调试时完全看不到你写的字。
<semantics></semantics> 结构写错，整个公式可能不显示
<semantics></semantics> 是容器，第一个子元素必须是 presentation 或 content MathML 主体，后续才是 <annotation></annotation>；顺序颠倒、多于一个主体、漏掉 <semantics></semantics> 外层，都会让浏览器放弃渲染整段 MathML：
- ✅ 正确：
<semantics><mrow><mi>a</mi><mo>+</mo><mi>b</mi></mrow><annotation encoding="text/plain">加法运算</annotation></semantics> - ❌ 错误：
<semantics><annotation>...</annotation><mrow>...</mrow></semantics>（annotation 在前 → 无效） - ❌ 错误：
<math><semantics>...</semantics></math>套两层 math → Safari 可能静默失败
Chrome 和 Firefox 对 <semantics></semantics> 结构校验较严，Firefox 尤其会直接跳过非法结构——不是报错，而是什么也不渲染，容易误判为“MathML 不支持”。
真正需要 <annotation></annotation> 的场景其实很少
除非你在做以下事情，否则大概率不需要它：
- 向学术论文系统提交可被自动提取公式的 HTML（需 machine-readable semantics）
- 构建支持公式语义搜索的教育平台（如按“求导”“矩阵逆”检索）
- 与 CAS（如 Mathematica、Sage）交互，把网页公式传给后端计算
日常教学页面、技术文档、博客里的公式，用好 <mtext></mtext>、CSS、HTML <figure>/<figcaption></figcaption></figure> 更可靠。把 <annotation></annotation> 当作“元数据抽屉”，不是“显示区域”。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
