Markdown/LaTeX公式一键转Word/WPS原生公式：开源工具全指南

我最初把它当“又一个 Markdown 转 Word 的小玩具”给忽略了，直到某次赶论文排版，需要把几十个 LaTeX 公式挪进 Word 文档，我才意识到这类工具真是程序员和学生都该收藏的“炸裂开源项目”。简单说，它解决的就是那个让人头大的问题：Markdown/LaTeX 里写公式一时爽，粘进 Word/WPS 火葬场。现在通过这个工具，你可以在笔记软件、VS Code、Obsidian 里用熟悉的 Markdown 和 LaTeX 语法写完公式，复制一下，再切到 Word 或 WPS 里一粘贴，得到的就是一个可以继续编辑、能同步改字号、能正常参与排版的原生公式对象，不是图片，不是乱码。

这个项目适合谁？凡是需要跟 Word/WPS 打交道、又习惯用 Markdown 或 LaTeX 记录知识的人，无论你是写课程作业的学生、准备论文的科研党，还是日常写技术文档、产品说明书的程序员，都会用得着。这篇文章我不打算只做“项目推荐”，而是把它背后的原理、部署方法、实操细节和常见问题全部讲透，你花半小时看完，之后写公式转 Word 的效率能翻好几倍。

1. 为什么 Markdown / LaTeX 公式转到 Word/WPS 这么麻烦

1.1 痛点场景：笔记里的公式进不了论文

我先描述一个很常见的场景。你平时在 Obsidian 或 VS Code 里写笔记，公式全都是 LaTeX 语法，比如行内公式$E=mc^2$，独立公式长这样：

$$ \int_{-\infty}^{+\infty} e^{-x^2}\,dx = \sqrt{\pi} $$

写的时候很舒服，渲染预览也很漂亮。但到了交实验报告、写毕业论文的时间，学校模板是 docx 格式，导师要求把公式作为“可编辑公式”提交，编辑器里带数学样式、能改字符那种。你总不能截一张图贴进去，更不能让导师打开你的 Markdown 文件。于是你就得在 Word 里对着公式重新敲一遍。如果公式少还好说，一旦有几十个公式，光对齐格式、调字体字号就能耗你一晚上。

WPS 和 Word 自带的公式编辑器并不是不好用，而是对于习惯了 LaTeX 的人来说太啰嗦：每个符号都要去工具栏里点点点，矩阵、分段函数、极限、积分这些结构更是折磨人。平时写笔记时用 Markdown 加 LaTeX 几分钟搞定的公式，在 Word 里可能要十几分钟。这就是这个开源项目出现的直接原因：你在 Markdown/LaTeX 里写完公式，复制粘贴进 Word/WPS，系统自动把它转成 Office 能识别的数学公式对象。

1.2 传统方案对比：为什么它们都不够“完美”

我先把市面上常见的几条路捋一遍，大家就明白为什么这个项目值得专门写一篇了。

这个开源项目的方案本质上是最后一种的“产品化升级版”，它把 LaTeX/UnicodeMath 语法解析、公式渲染、格式转换、剪贴板写入这一串流程打包成了“一键操作”。本质上就是：你负责在编辑器里选中公式，它负责把公式变成 Word/WPS 能直接接收的格式对象。

提示：这里说的“完美粘贴”，指的是粘过去之后公式是原生 OMML 对象，你可以在 Word/WPS 的公式编辑状态下继续修改它，而不是一串冰冷代码或一张图。能做到这一点的开源项目，真的比想象中少。

1.3 为什么选择 LaTeX 语法作为输入标准

可能有人会问：为什么非要先写 LaTeX，不直接在 Word/WPS 里输入公式？原因很简单。LaTeX 的数学语法可以说是理工科的“通用语言”，它的表达能力极其完整，从上下标、根式、分式到矩阵、分段函数、多行对齐公式，都有一套成熟、稳定的语法规则。你用 Markdown 记录笔记时，公式几乎必然是 LaTeX 风格，不管你是用 KaTeX、MathJax 渲染，还是用 Typora、Obsidian，这套语法都通用。

因此，一个能“读懂” LaTeX 公式并把它转换为 Office 原生公式的桥梁型工具，天然就是最适合程序员和学生的。它的意义在于：你不必改变自己原有的书写习惯，只需要把 Markdown 里的公式复制出来，剩下的语法解析、结构转换、格式封装工作全部交给程序完成。代码工作者管这叫“协议适配层”，学生党可以理解为“万能转换插头”。

2. 核心原理：LaTeX 公式是怎么进入 Word/WPS 的

2.1 从 LaTeX 到 OMML：认识 Word 公式的“母语”

很多人不理解 Word 里的公式到底是什么格式。它既不是 LaTeX 源码，也不是 MathML，而是微软自定义的一套 XML 标记语言，叫OMML（Office Math Markup Language）。你在 Word 里按“Alt + =”进入公式编辑状态，输入内容并保存后，文档底层存的其实是一堆复杂的 XML 标签，比如分数结构<m:f>、根式结构<m:rad>、上标<m:sSup>。这些标签共同描述了一个数学表达式的结构，再由 Word 渲染成你看到的漂亮公式。

所以“一键把 LaTeX 粘贴到 Word”这个流程，本质上要解决的是LaTeX → OMML的语法树转换问题。你不能直接把\frac{a}{b}字符丢给 Word，Word 读不懂它。你需要先把公式解析成一个数学结构树，再按 OMML 的规则把这棵树序列化成 XML 片段。

以这个开源项目常见的实现方式来看，通常会用 JavaScript 的语法解析器把 LaTeX 字符串拆成抽象语法树，然后遍历这棵树生成对应的 OMML 节点。比如遇到\frac{1}{2}就生成一个<m:f><m:num><m:t>1</m:t></m:num><m:den><m:t>2</m:t></m:den></m:f>这样的结构。听起来复杂，但好在开源生态里已经有人把 LaTeX 语法解析和 OMML 转换这部分做成了库，这个项目做的就是把这些零件组装起来，再配上一个方便的剪贴板交互层。

2.2 为什么还需要“渲染预览”这一步

只做转换还不够，因为用户必须能确认自己复制的公式没有语法错误。这就是这个开源项目里“预览”模块的价值。它会用 KaTeX 或 MathJax 这类 JavaScript 渲染库，把 LaTeX 公式渲染成浏览器/桌面端界面里的可视化效果。这样你复制公式后，在工具窗口里能立刻看到渲染结果，确认无误再点粘贴。换句话说，这个工具同时充当了“语法校验器”和“所见即所得预览器”。

有些使用方式甚至不需要打开额外窗口：你复制公式后，直接切到 Word/WPS 里按 Ctrl+V，工具常驻后台，监听剪贴板变化并自动处理。但默认情况下，我会建议先盯一眼预览，尤其是第一次使用、还不熟悉边界情况的时候。公式一旦被转换成了 Word/WPS 对象，再想找回原始 LaTeX 代码就比较费劲了，转换前检查这一步是值得的。

2.3 剪贴板里到底放了什么

你可能好奇，复制一个 LaTeX 公式后，剪贴板里被塞进去的是什么？如果只是普通文本\frac{a}{b}，Word 肯定不认。为了让 Word 能“识别并粘贴为公式”，这个项目需要在剪贴板中写入特殊格式的数据。

Windows 剪贴板支持多种格式并存。一个公式被复制后，剪贴板里通常会有：

• HTML/CF_HTML：可能是公式的图片或渲染后的 HTML 结构，用于支持一些富文本编辑器
• Unicode 文本：一般是 LaTeX 源码或者 UnicodeMath
• MTEF：MathType 的公式二进制格式，如果你装了 MathType 它就能认
• OMML：微软 Office 公式标记语言，Word/WPS 是否能粘贴成原生公式，关键就看有没有这个格式

这个项目的核心动作之一，就是把 OMML 以正确的 Windows 剪贴板格式写入系统，并且通常需要放在适合 Office 读取的优先级位置。这样 Word 拿到剪贴板内容时，发现里面包含 OMML 数据，就会优先按原生公式解析，而不是当成普通文本粘贴。也正是这一步，决定了它是“公式粘贴”而不是“代码粘贴”。

注意：这个机制在正版/官方版 WPS 和 Microsoft Word 上表现最稳定。如果你用某些来路不明的绿色版、精简版 Office，剪贴板接口可能被阉割，工具会时灵时不灵，问题大概率不是工具，而是软件环境。

2.4 和 MathType / 公式图片识别 / 在线转换的关系

搜索热词里常见“math type 与 word 字号对照表”“公式图片转 word”“word 公式转 latex”之类需求，这里我也顺便理清楚工具边界。这个开源项目解决的是“从 LaTeX 到 Word/WPS 的原生公式粘贴”，它跟以下场景完全不同：

• 公式图片转 Word：需要 OCR 识别图片里的公式，再还原为 LaTeX 或 OMML，属于另一类工具。如果手里只有公式截图，应该先去找 “Pix2Text” 或在线公式 OCR 服务，得到 LaTeX 代码后再用这个项目粘进 Word。
• 在 Word 里输入 LaTeX：Word/WPS 本身就支持一些 LaTeX 输入模式，比如在公式框里输入\sqrt再按空格，但支持范围有限且依赖输入法。这个项目的价值在于，你不需要在 Word 公式编辑器里“打字”，任何来源的 LaTeX 公式都能一键落入文档。
• 整篇 Markdown 转 Word：如果你想连标题、表格、代码块一起转，Pandoc 才是你的主力。这个项目更像是精准手术刀，只负责公式这一块。

理解了这个原理，后面遇到问题时你自己的排查能力会强很多。很多人用不起来，就是没搞清楚“你复制的内容到底是什么格式”。

3. 环境准备：部署这个开源工具的最小步骤

3.1 前置要求：别小看运行环境

因为这类工具大多基于 Web 技术栈写成，所以一般要求你本地有 Node.js 和 npm（或者 pnpm/yarn）环境。个别项目还会提供预编译的 exe 版本，那就是开箱即用的，不用装环境。我建议你优先找提供 Windows 预编译包的版本，毕竟 Word/WPS 用户以 Windows 为主，作者打包成 exe 后大家用得省心。

如果没有现成的 exe，那自己从源码跑也很快。以一套典型的 Node.js 项目为例，部署流程是这样的：

# 克隆项目（仓库名会出现在项目主页，这里不具体指某一家） git clone <仓库地址> cd 项目目录 # 安装依赖 npm install # 启动开发模式 npm run dev

我实际用下来，npm install阶段最容易出问题，主要原因是网络超时和依赖版本冲突。如果你在中国大陆地区，把 npm registry 切到国内镜像会顺畅很多：

npm config set registry https://registry.npmmirror.com

不同项目的命令略有差异，但只要是“复制公式 - 转换 - 粘贴”这个交互模型，整体结构都差不多。GitHub 页面一般会有截图和 GIF 演示，你下载前先看一眼 README 和 release 区，确认它支持的操作系统和 Office 版本，再决定跑不跑。

3.2 关键依赖：解析库与剪贴板库的选择

一个合格的这类开源项目，背后通常依赖这么几个核心库。理解这些依赖能帮你判断一个工具靠不靠谱：

其中latex2omml这种转换器的兼容度是最关键的。这么多 LaTeX 宏包和语法变体，一个转换器不可能全覆盖，所以你会看到有些项目 README 里专门写了支持范围：“支持\frac、\sqrt、\sum、\begin{matrix}等常见结构，复杂宏包如\ce{}不支持”。我建议你在部署之前先看一眼这个支持范围清单，别等用完才发现自己天天用的\hline它不支持。

3.3 安装注意事项：给小白的三个提醒

第一，解压路径不要带中文或特殊字符，比如D:\软件\MathPaste这种路径在某些情况下会引起 Electron/Tauri 的剪贴板权限问题。第二，如果你电脑上装了 MathType 和 AxMath 两个工具，确实会出现热词里那种“插入公式跳出来的是 MathType”的冲突情况，这不影响本工具的 LaTeX 粘贴流程，但你可能需要在 MathType 的“Format”里重新指定 Word 命令快捷键，否则 Word 里 Alt+Q（MathType 默认快捷键）会被后者拦截。第三，把工具固定在任务栏或设为开机启动，能省掉你每次手动打开的功夫。我个人更推荐“用之前打开、用完关掉”的习惯，一个常驻内存的转换脚本没有太大必要长期挂着。

4. 实操全过程：从写公式到完美粘贴进 Word/WPS

4.1 在 Markdown 里写公式的正确姿势

既然输入源是 Markdown/LaTeX 公式，我们就把源头做好。在你的 Markdown 编辑器里，务必注意行内公式和块级公式的区别。行内公式用两个美元符号夹住，如$x^2+y^2=z^2$；块级公式用两个美元符号占用一整行且前后留空行：

$$ \begin{pmatrix} a & b \\ c & d \end{pmatrix} $$

如果你要复制公式，一定要确保复制的文本包含完整的 LaTeX 源码，而不是复制渲染后的图片效果。以 Obsidian 为例，在实时预览模式下用鼠标拖动选中的常常是渲染后的内容，粘出去就变成了图片或 HTML。这时最稳妥的做法是切到源码模式再复制，或者点一下公式代码块，光标定位后全选复制。这个细节不处理好，后面工具接收到的可能根本不是 LaTeX 文本，自然转换不出来。

4.2 启动工具并确认剪贴板格式

打开这个开源工具之后，它的界面一般会有一个实时监测区域或一个“转换并复制”按钮。我用过的体验比较好的设计是：你复制任意 LaTeX 片段，工具会自动检测剪贴板里是否含有可识别的 LaTeX 标记，如果有就自动预览、自动转换，并提示“现在可以去 Word 里粘贴了”。你也可以手动把 LaTeX 粘贴到工具输入框，它同样会给出预览和转换结果。

判断工具是否正常工作，一个很简单的测试方法：在 Markdown 文件里写一个简单公式$a^2+b^2=c^2$，复制，打开工具，如果预览区显示出了正确的上下标公式，说明输入侧没问题；接着切到 Word/WPS，按 Ctrl+V，如果粘贴结果是可以直接点进去编辑的公式对象，而不是纯文本a^2+b^2=c^2，说明转换链路全部通畅。

4.3 实战案例：几条不同复杂度的公式转换

我挑三个有代表性的公式走一遍，让大家感受一下覆盖度。

基础公式：幂运算与希腊字母

$E=mc^2$

复制后粘贴到 Word 里，你得到的就是标准的E = mc²，而且可以选中mc²里的 2 继续修改。这看似简单，但它证明了 OMML 结构被正确创建了，不是普通文本。

中等公式：极限与定积分

$$ \lim_{x \to +\infty} \frac{1}{x} \int_0^x f(t)\,dt = \bar{f} $$

转换到 Word 后，极限下面的x → +∞会变成下标的限制位置，积分上下限会正确放在积分号的右上和右下，这个结构完整度比 MathType 默认粘贴体验要自然得多。\,这类细空格在 LaTeX 里用来给被积函数和微分符号之间留空隙，好的转换器会保留间距。

复杂公式：矩阵与分段函数

$$ f(x) = \begin{cases} x^2, & x \ge 0 \\ -x, & x < 0 \end{cases} $$

这个公式在 Word 公式编辑器里手工做要花不少时间：插入花括号、选择“括号对”、插入两行矩阵、调整列对齐。用这个工具一条命令就完成。粘贴后，你甚至能在 Word 的公式工具栏里看到它被自动识别为“分段函数”结构，接下来想加行、删行都非常容易。

实测下来，这个项目的转换成功率大概在 90% 以上，剩下 10% 基本是 LaTeX 特例语法和 Office 数学结构对不上的情况，比如带\boldsymbol的粗体符号格式，或者某些\mathcal花体字符。遇到这种情况我会先简化公式，再用 Word 自带公式编辑器补一下样式，问题不大。

4.4 整篇文档公式处理的补充：Pandoc 配合

单条公式靠剪贴板工具，整篇文档批量转建议用 Pandoc 配合。热词里有“markdown 转 word 工作流 coze”，也有“deepseek 输出的文档怎么导出为 word”，这类需求本质上是想批量处理。我的组合拳是：

pandoc input.md -o output.docx \ --mathml \ --from markdown+tex_math_dollars \ --metadata title="论文标题" \ --highlight-style=tango

Pandoc 会直接把整个 md 文件转成 docx，公式同样会以 OMML 形式进入 Word。但它的缺点是排版样式比较“素”，标题层级、字体、间距需要你在 Word 里再套一遍模板。所以我通常先用 Pandoc 拿到初稿，再手工调整公式密度较高的段落。这个开源项目则用来做“局部补救”——比如我需要在某个表格里插入一个行内公式，直接复制粘贴进去，而不想动整篇文档。

5. 常见问题与排查技巧实录

用这类工具最怕的就是“满怀期待地粘贴，结果 Word 里啥也没有”或者“粘出来一堆 XML”。我在实际使用中踩过不少坑，整理了一份问题速查表，按概率从高到低排列。

除此之外，有几个容易被忽略的细节我想专门拎出来聊聊。

第一个是 Word 的公式编号问题。理工科论文经常要求公式居中等距，编号右对齐。我用工具粘贴出来的公式是一个 OMML 对象，如果文档里要求公式居中且带编号，需要自己在 Word 里做一个带制表位的样式：在段落开始处插入一个居中制表位，再在结束处插入一个右对齐制表位，然后按住 Tab 输入公式，再 Tab 到末尾输入编号(1)。这个步骤和工具的粘贴能力是独立的两件事，但配合起来非常丝滑。

第二个是 WPS 的特殊情况。WPS 和 Microsoft Office 对 OMML 的兼容性并不完全相同，个别版本的 WPS 会优先把剪贴板内容当作富文本而不是数学对象处理。我在 WPS 2019 个人版上测过一次，结果是“粘贴为对象失败”，在 WPS 新版上又成功了。如果你用的是 WPS，建议把软件升级到最新版，并在粘贴时留意右键菜单里是否有“粘贴公式”之类的独立选项。还有，WPS 官方个人版已经够用，不需要去捣鼓什么“wps 破解版”“纯净版”，既不合规还容易出问题。

第三个是字号与对齐。热词里有一条 “mathtype 与 word 字号对照表”，说的是 MathType 里定义的 12pt 对应 Word 里的 12pt，但很多工具把 LaTeX 转成 OMML 后，公式默认继承 Word 当前段落的字体大小。这意味着如果你在正文用小四号字复制公式，粘贴出来的公式也会自动跟随小四号。如果你需要公式单独大一号，可以在 Word 公式工具里直接改字号，或者先给光标设置好字体大小再粘贴。这也是用 OMML 对象比图片优越的地方：图片不能改字号，公式对象可以随便改。

第四个是与你电脑上已有的数学软件打架。热词里“为什么电脑里同时安装了 axmath 和 mathtype，在 word 内用 axmath 插入公式，跳出的是 math”这种情况，本质是多个加载项抢注 Word 的 COM 按钮和快捷键。这个开源工具一般不抢快捷键，因为它只监听剪贴板，不修改 Word 界面，所以和 MathType/AxMath 能和平共处。但如果你发现粘贴公式时 Word 卡顿或者弹出数学助手窗口，可以在 Word“选项 - 加载项”里临时禁用 MathType 的 COM 加载项，再试一次。

第五个是输入法干扰。程序员和学生党经常挂着中文输入法，在 Markdown 里复制公式时可能多复制进一个全角空格或者换行符。LaTeX 解析器对多余空格一般能容忍，但全角字符可能让它解析失败。所以复制的公式最好在工具预览框里确认一下，如果发现只多了一个空格不会有什么问题，如果出现全角括号、全角逗号，那大概率是输入法闯的祸，回源码里重新复制一遍。

第六个是版本兼容的普适法则。这类开源项目迭代速度很快，但公式语法标准和 Office 版本更新速度都不慢。如果某天你换了一个新版本工具，发现某些公式从“能粘贴”变成了“粘贴出来为空”，那多半是转换器的解析 schema 变了。我的建议是：固定一个你验证过所有公式的版本，不要频繁升级，除非遇到严重 bug。GitHub 上的新 release 不一定更适合你的日常需求，稳定优先。

提示：如果你遇到“复制到 Word 里能粘贴，但是粘贴出来是代码块 XML”的问题，检查一下是不是用了“复制为 Markdown”的插件，它会覆盖系统剪贴板格式。对，我说的就是那些 Markdown 编辑器增强插件，它们也会往剪贴板里塞自定义格式，覆盖工具写入的 OMML。解决办法是临时禁用插件，或者用工具提供的快捷方式绕过粘贴板覆盖。

6. 我的一些细节经验与改进想法

其实这类“中转粘贴工具”做得久了，你会发现用户真正需要的不只是一个转换器，而是一条完整的工作流。这里把我个人沉淀的脑袋里的小经验分享出来。

第一，在笔记软件里建立一个“公式速查模板”库。把常用的行内公式、矩阵模板、分段函数模板、积分极限模板都整理成一个 Markdown 文件，每次要用直接复制，省得临时回想 LaTeX 语法。比如我在 Obsidian 里建了一个公式速查.md，内容分类清晰，粘公式时直接从里面挑，效率非常高。

第二，批量场景升级为“Pandoc + 剪贴板工具”双通道方案。整篇 Markdown 需要转成 docx 格式时，先用 Pandoc 转换，处理标题、列表、代码块和大部分基础公式；然后打开 Word 检查那些 Pandoc 没转好或你后来单独加的公式，用剪贴板工具逐条补上。这个打法兼顾“批量”和“精细”，实测下来比单一工具顺手得多。

第三，配合自动化脚本做成“格式解析小管线”。如果你手头公式特别多，比如几十个测试题的答案，你可以写一个简单的 Python/Node 脚本，读取目录下的.md文件，把所有$$...$$内容抽出来，循环调用这个工具的转换接口，生成一个.docx文件。这样你就不用在图形界面里一个个点了。具体实现要看工具是否提供 CLI 接口，我见到的部分是提供命令行模式的，用起来很香。

第四，注意邮箱和网页富文本场景。这个工具主要面向 Word/WPS 桌面端，如果你要在邮件里插入公式，或者在 Notion 网页版里粘贴公式，那它的能力会受限。Windows 剪贴板里的 OMML 数据只有在 Office 应用里才被识别，网页邮箱通常只会收到纯文本或 HTML。如果你有这类需求，建议看看支持 LaTeX 渲染的博客/笔记平台，或直接把公式图片化嵌入邮件，别硬用这个工具。

第五，学会从公式的“生成端”反推问题。很多时候公式粘不过来，不是因为转换器不行，而是你的 LaTeX 本身也不是标准写法。例如 Markdown 里常见的\dfrac（加大尺寸的分式）在标准 LaTeX 数学环境中需要amsmath宏包，有些解析器不认\dfrac，但认\frac。遇到转换失败，先把\dfrac换回\frac试试，优先使用最基础的 LaTeX 数学环境命令，可以提升 80% 的兼容性。同样，\begin{aligned}和\begin{align}有不同的对齐语义，转换器支持情况也不一样，建议只使用常见环境。

第六，从“复制粘贴”扩展到“模板化写作”。当你把公式粘贴流程跑顺了之后，可以把实证类、理工科实验报告的写作流程也标准化：用 Markdown 管理笔记和思路，用 LaTeX 公式表达数学推导，最后整体转 docx 提交。这个流程一旦建立，你会发现自己的科研/学习节奏都顺了很多。毕竟工具永远只是手段，真正提升效率的是“一个稳定、可复现的处理范式”。

再分享一个小技巧：如果你在 Word 里频繁粘贴公式，把工具设置里的“自动转换并常驻剪贴板”打开。这样你的正常复制不会被干扰，但一旦剪贴板里出现了能被识别为 LaTeX 公式的内容，工具会自动把它替换成带 OMML 的对象。你什么都不用做，切到 Word 里一粘贴就是公式。我用这个模式整整一个学期，写作业的效率高了不少，因此这个开源项目是我个人近期最想安利给同学和同事的产品。如果你之前因为公式转换的麻烦一直抗拒 Word/WPS 提交作业，我强烈建议你花十分钟把它装起来，把第一个简单的$\frac{a}{b}$粘贴进去，感受一下那种“写公式终于不用换脑”的爽快感。