技术文档、检验报告与教案里的公式,过去常以截图的形式贴进 Word:放大后字迹发虚,改一个下标就要重新截图;交给别人编辑时,也无法像正文那样选中、调整字号。Word 从 2007 版起改用 OfficeMath 保存公式,公式成为文档模型里的原生对象,可以编辑、随字号缩放,也能被程序读取和复用。
本文用 Spire.Doc for JavaScript 在浏览器中把 LaTeX、MathML 与 OMML 三种来源写成 Word 原生公式,再把文档里已有的公式读出来、导出为文本。整个过程基于 WebAssembly 在浏览器端完成,无需安装 Office,也不依赖后端,文档始终留在用户的设备上。
本文介绍三个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Doc for JavaScript。下面的示例假定 Spire.Doc 已安装、WebAssembly 模块已初始化。
OfficeMath 与三种公式输入格式
OfficeMath 是段落级的对象,不能脱离段落单独存在。使用时先在文档中创建它,用转换方法写入公式内容,再通过 ChildObjects.Add() 挂到目标段落上。三种输入格式对应三个转换方法,最终得到的都是同一个原生公式对象:
| 方法 | 输入 | 适合的场景 |
|---|---|---|
FromLatexMathCode(latex) |
LaTeX 字符串 | 手写公式、按模板批量生成 |
FromMathMLCode(mathML) |
MathML 字符串 | 从网页、数学软件或排版系统导出 |
FromOMMLCode(omml) |
OMML 字符串 | 复用 Word 文档里已有的公式 |
来源只影响“怎么把公式写进去”。写入之后,无论是插入、排版还是读取导出,三种方式的行为一致。因此挑选格式时,看上游给的是什么即可,不必为了统一而先做一次转换。
由 LaTeX 插入数学公式
LaTeX 的写法紧凑,适合手写,也容易由程序按模板拼接。示例使用一份产品质量统计报告 Report.docx,正文里预先留出了“标准差计算公式:”一行,代码在这一段末尾追加公式。
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 载入字体与
Report.docx,创建Document对象并加载文档。 - 遍历正文段落,找到包含“标准差计算公式:”的段落。
- 创建
OfficeMath对象,用FromLatexMathCode()写入公式,再通过ChildObjects.Add()加到该段落。 - 保存为 docx,从 VFS 读出结果并触发浏览器下载。
由 LaTeX 插入数学公式的代码如下:
function App() {
const insertLatexEquation = async () => {
// 获取 Spire.Doc 的 WASM 模块
const docModule = window.wasmModule?.spiredoc;
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 载入字体与示例报告
await window.spire.FetchFileToVFS('ARIALUNI.TTF', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
await window.spire.FetchFileToVFS('Report.docx', '', `${process.env.PUBLIC_URL}/data/`);
const doc = new docModule.Document();
doc.LoadFromFile('Report.docx');
// 找到公式占位段落
let paragraph = null;
const body = doc.Sections.get_Item(0).Body;
for (let i = 0; i < body.ChildObjects.Count; i++) {
const obj = body.ChildObjects.get_Item(i);
if (obj.DocumentObjectType !== docModule.DocumentObjectType.Paragraph) continue;
if (String(obj.Text || '').includes('标准差计算公式:')) {
paragraph = obj;
break;
}
}
if (!paragraph) {
alert('没有找到公式占位段落');
doc.Dispose();
return;
}
// 创建公式对象,按 LaTeX 写入,再追加到段落
const math = new docModule.OfficeMath(doc);
math.FromLatexMathCode('\\sigma = \\sqrt{\\frac{\\sum_{i=1}^{n}(x_i - \\bar{x})^2}{n}}');
paragraph.ChildObjects.Add(math);
// 保存结果文件
const outputFileName = 'ReportWithEquation.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
});
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>插入数学公式</h1>
<button onClick={insertLatexEquation}>插入公式</button>
</div>
);
}
export default App;
插入后,公式出现在“标准差计算公式:”之后,与正文排在同一段,双击即可进入 Word 的公式编辑状态:

反斜杠转义
LaTeX 命令以反斜杠开头,而 JavaScript 字符串里的反斜杠本身是转义符。写进普通字符串时,每个反斜杠要写两次:\sigma 写成 \\sigma,\frac 写成 \\frac,\bar{x} 写成 \\bar{x}。
漏写往往不会报错,而是悄悄改掉内容:\f 是换页符,\b 是退格符,\t 是制表符,\n 是换行符。'\frac{a}{b}' 实际得到的是“换页 + rac{a}{b}”,公式因此残缺或变形。
不想逐层数反斜杠时,可以用 String.raw 保留原始字符:
const latex = String.raw`\sigma = \sqrt{\frac{\sum_{i=1}^{n}(x_i - \bar{x})^2}{n}}`;
math.FromLatexMathCode(latex);
String.raw 只影响反斜杠的处理方式,公式内容与上面完全一致。模板字符串里的 ${ 仍会触发插值,遇到时需要单独处理。
转换方法本身不校验 LaTeX 是否完整。括号缺失或命令未闭合时,得到的可能是一个空分母,而不是异常提示。由程序拼接公式时,转换前检查括号与命令是否成对,可以少走弯路。
同一段落里混合文字与公式
公式是段落的一个子对象,加入位置就是它在段落中的位置。先在段落里追加前一段文字,再添加公式,最后追加后一段文字,就能得到“文字—公式—文字”的顺序:
const paragraph = doc.Sections.get_Item(0).AddParagraph();
paragraph.AppendText('样本标准差 ');
const math = new docModule.OfficeMath(doc);
math.FromLatexMathCode('\\sigma');
paragraph.ChildObjects.Add(math);
paragraph.AppendText(' 用于衡量尺寸波动。');
如果顺序需要调整,按同样的方式重新组织 ChildObjects 即可。需要让公式独占一行时,把它单独放进一个段落,排版会更稳定。
AppendText 为什么不会生成公式
公式是否按 OfficeMath 渲染,取决于它是否作为 OfficeMath 对象挂到段落上。把 LaTeX 字符串直接交给 AppendText(),写入的是普通文本,外观上与公式相近,但不可编辑,也不参与公式排版。
// 得到的是文本,不是公式
paragraph.AppendText('\\sigma = \\sqrt{x}');
// 先创建公式对象,再加入段落
const math = new docModule.OfficeMath(doc);
math.FromLatexMathCode('\\sigma = \\sqrt{x}');
paragraph.ChildObjects.Add(math);
OfficeMath 创建后如果没有通过 ChildObjects.Add() 加入段落,也不会出现在文档里。写完公式后检查这一步,可以排除大部分“公式不见了”的情况。
由 MathML 与 OMML 插入数学公式
从网页复制公式、从数学软件导出时,通常拿到的是 MathML;从 Word 文档里提取时,拿到的是 OMML。两种格式都能直接写入公式对象,不必先手工转成 LaTeX。示例继续在上一节生成的文档中,把平均值公式写入“平均值公式:”这一行。
具体操作步骤如下:
- 载入上一节生成的
ReportWithEquation.docx。 - 遍历正文段落,定位包含“平均值公式:”的段落。
- 创建
OfficeMath对象,按来源调用FromMathMLCode()或FromOMMLCode()。 - 通过
ChildObjects.Add()把公式加到段落。 - 保存并下载结果。
由 MathML 与 OMML 插入数学公式的代码如下(先以 MathML 为例):
// 先定位“平均值公式:”段落
const body = doc.Sections.get_Item(0).Body;
let paragraph = null;
for (let i = 0; i < body.ChildObjects.Count; i++) {
const obj = body.ChildObjects.get_Item(i);
if (obj.DocumentObjectType !== docModule.DocumentObjectType.Paragraph) continue;
if (String(obj.Text || '').includes('平均值公式:')) {
paragraph = obj;
break;
}
}
// 把 MathML 写入公式对象,再追加到段落
const mathML = `
<math xmlns="http://www.w3.org/1998/Math/MathML">
<mfrac>
<mrow><mi>a</mi><mo>+</mo><mi>b</mi></mrow>
<mn>2</mn>
</mfrac>
</math>`;
const math = new docModule.OfficeMath(doc);
math.FromMathMLCode(mathML);
paragraph.ChildObjects.Add(math);
写入后的分式与 LaTeX 生成的公式没有区别,都是 Word 原生对象:

MathML 片段的根元素与命名空间
MathML 片段要以 <math> 为根元素,内部再放 <mfrac>、<msqrt>、<mi> 等节点。网页上选中复制时,若只框住了内部节点,拿到的是没有根的片段,解析后往往得不到完整公式。复制后先确认字符串以 <math 开头、以 </math> 结尾,再交给 FromMathMLCode()。
<math> 上的 xmlns 声明建议一并保留。不同来源的片段在命名空间写法上差别较大,带上原始声明可以减少解析差异;同时 MathML 描述的是公式结构,网页里的字号、颜色等样式一般不会随之进入文档,需要按 Word 的正文格式重新设置。
OMML 从哪里来
OMML 是 Word 保存公式的内部格式,通常不手写。需要复用已有公式时,有两条路:从 docx 的 XML 中提取 <m:oMath> 节点,或者先用 FromLatexMathCode() 生成公式,再用 ToOfficeMathMLCode() 把它取出来保存。
取出的 OMML 可以再次交给 FromOMMLCode(),在另一个位置生成同样的公式:
// 生成一个公式并取出它的 OMML
const source = new docModule.OfficeMath(doc);
source.FromLatexMathCode('E = mc^2');
const omml = source.ToOfficeMathMLCode();
// 在另一个段落复用这段 OMML
const copy = new docModule.OfficeMath(doc);
copy.FromOMMLCode(omml);
const target = doc.Sections.get_Item(0).AddParagraph();
target.AppendText('质能方程:');
target.ChildObjects.Add(copy);
OMML 字符串自带 m: 与 w: 命名空间声明,传递时整段保留即可,不要只截取 <m:oMath> 的内部节点。
读取并导出数学公式
公式归档、内容迁移或建立检索索引时,需要把 Word 里已有的公式还原成文本。读取时按“节 → 正文 → 段落 → 子对象”的顺序遍历,找到类型为 OfficeMath 的子对象,再调用对应的转换方法。
具体操作步骤如下:
- 载入含公式的
ReportWithMathML.docx。 - 逐节遍历正文中的段落。
- 在段落子对象中判断
DocumentObjectType.OfficeMath。 - 调用
ToLaTexMathCode()、ToMathMLCode()或ToOfficeMathMLCode()收集结果。 - 把结果序列化为 JSON,触发浏览器下载。
读取并导出数学公式的代码如下:
const formulas = [];
for (let s = 0; s < doc.Sections.Count; s++) {
const section = doc.Sections.get_Item(s);
for (let i = 0; i < section.Body.ChildObjects.Count; i++) {
const obj = section.Body.ChildObjects.get_Item(i);
if (obj.DocumentObjectType !== docModule.DocumentObjectType.Paragraph) continue;
for (let k = 0; k < obj.ChildObjects.Count; k++) {
const child = obj.ChildObjects.get_Item(k);
if (child.DocumentObjectType !== docModule.DocumentObjectType.OfficeMath) continue;
formulas.push({
latex: child.ToLaTexMathCode(),
mathml: child.ToMathMLCode(),
});
}
}
}
const json = JSON.stringify(formulas, null, 2);
const blob = new Blob([json], { type: 'application/json' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'Formulas.json';
a.click();
URL.revokeObjectURL(url);
示例文档里有两个公式,导出结果各占一条记录:

三种文本格式的用途
| 方法 | 输出 | 适合的用途 |
|---|---|---|
ToLaTexMathCode() |
LaTeX 字符串 | 存档、迁移到其他排版系统 |
ToMathMLCode() |
MathML 字符串 | 跨平台交换、网页展示 |
ToOfficeMathMLCode() |
OMML 字符串 | 原样写回 Word 文档 |
三个方法都只读取、不修改原文档。需要保留公式外观时,优先保存 docx 原件;导出的文本更适合作为索引、备份或转换的中间结果。
导出的 LaTeX 与手写的不完全一样
转换要经过 OMML 这一层,输出的 LaTeX 是规范化后的写法,与输入不一定逐字符相同。例如输入:
'\\sigma = \\sqrt{\\frac{\\sum_{i=1}^{n}(x_i - \\bar{x})^2}{n}}'
导出后得到:
\sigma =\sqrt{\frac{∑_{i=1}^{n}\left(x_{i}-\bar{x}\right)^{2}}{n}}
求和符号、括号与花括号的写法都发生了变化,公式含义不变。下游若按字符串比对公式,先统一格式再比较,或者改用 MathML / OMML 作为交换格式,结果会更稳定。
三个功能点的对照
| 任务 | 主要方法 | 关键点 |
|---|---|---|
| 由 LaTeX 插入数学公式 | FromLatexMathCode() |
反斜杠需转义 |
| 由 MathML 插入数学公式 | FromMathMLCode() |
保留 <math> 根元素 |
| 由 OMML 插入数学公式 | FromOMMLCode() |
来自 Word 内部格式 |
| 读取并导出数学公式 | ToLaTexMathCode() 等 |
输出为规范化写法 |
公式方案的核心是“用原生对象,而不是图片”。原生公式可以编辑、能随字号缩放,也便于后续提取与复用;只有当公式需要固定外观、脱离源文件展示时,才考虑另存为图片。
常见问题
插入后的公式为什么显示为纯文本
通常是把 LaTeX 字符串直接交给了 AppendText(),写入的是文本而不是公式对象。先创建 OfficeMath,用 FromLatexMathCode() 写入内容,再通过段落的 ChildObjects.Add() 加入文档,才会按原生公式渲染。
LaTeX 里的反斜杠为什么会丢失
JavaScript 字符串把反斜杠当作转义符,\f、\b、\t 会变成换页、退格、制表等控制字符。写 LaTeX 时把每个反斜杠写成两个,或改用 String.raw 模板,能避免这类问题。转换前打印一下字符串,很容易看出是否被提前转义。
从网页复制的 MathML 为什么解析不出公式
常见原因是片段不完整:只复制了 <mfrac> 等内部节点,缺少 <math> 根元素。换用包含根元素的完整片段,再保留原有的 xmlns 声明,解析成功率会更高。若片段来自富文本编辑器,还需要确认标签闭合、属性引号完整。
本文的示例需要把文档上传到服务器吗
不需要。Spire.Doc for JavaScript 基于 WebAssembly 在浏览器端运行,文档通过虚拟文件系统(VFS)在本地读写,插入、保存与读取都在本地完成,库本身不会把文件发往服务器。文件最终是否离开设备,取决于你在页面上另外接入的代码。
一次可以插入或导出多个公式吗
可以。插入时每个公式创建一个 OfficeMath 对象,分别加到目标段落;导出时遍历所有段落与子对象,把结果累积到数组即可。文档里公式较多时,可以按段落文字或顺序定位,避免只处理第一处。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







