在Word里辛辛苦苦排好的公式复制粘贴到WordPress后台刷新一看要么变乱码、要么整个公式“凭空消失”这种情况你做WordPress建站或维护博客时大概率碰到过。尤其是有数学、物理、工程内容的站长对这种“公式显示异常”绝对不陌生。我先说结论这跟Word或WordPress哪一段出了bug都没关系本质是“公式格式不兼容”导致的。Word内部用的是自家专用的OMML数学标记语言而WordPress页面只认HTML、CSS和JavaScript能处理的内容。两边互不认识粘贴过去自然水土不服。这篇文章我直接把实操过程串起来给你讲透从Word公式底层格式讲起到公式怎么转成LaTeX再到WordPress里怎么部署MathJax洪染最后给几套可以直接抄的端到端工作流。适合个人站长、教育类博主、科技资讯编辑以及任何需要定期把含公式的文档发布到WordPress的从业者参考。1. 先弄明白Word 公式在 WordPress 里为什么不兼容1.1 Word 公式的底层格式OMML 是座“孤岛”微软在Office 2007之后把数学公式默认存储格式换成了OMMLOffice Math Markup Language。这是一种基于XML的专用标记语言专门描述公式的层级结构、符号位置和排版关系。你随便在Word里插入一个公式比如最简单的二次方程求根公式它在文档底层就是一大段OMML标签。问题是OMML是微软自家的格式。Word能完美解析它是因为Word认识这种结构但浏览器、WordPress编辑器、主流网页脚本都不认识。你把公式从Word里复制出来剪贴板里同时携带了多种格式的数据纯文本、HTML片段、RTF富文本、OMML XML等。粘贴进Word时Word会优先读取OMML那层数据所以看起来“原封不动”。但当目标环境是WordPress的编辑器时编辑器后端不认OMML前端浏览器也不认公式自然就得不到正确解析。1.2 复制粘贴过程中到底发生了什么在Word中复制一个含公式的段落粘贴到WordPress古腾堡编辑器或经典编辑器里这个过程至少会经历两次“格式过滤”。第一次过滤发生在浏览器接收剪贴板数据时。WordPress的编辑器为了安全会剥掉大量它认为不安全的标签OMML标记往往就在被剥掉的范围里。第二次过滤发生在内容保存时。WordPress的wp_kses等过滤机制会再次清洗内容剩下的公式信息就所剩无几了。所以你会看到几种典型表现公式整体消失只留下前后的说明文字公式变成一段看不懂的Xml代码公式变成了图片但图片链接失效或者公式的上下标、根号、分式被拍扁成普通文本。我见过最夸张的情况是一个矩阵公式粘贴后只剩下一堆\begin之类的碎片文本连个完整符号都没留下。1.3 解决思路把“对象”翻译成 LaTeX既然直接粘贴不行就得换思路。数学公式在网页端目前最成熟、兼容性最好的文本表达方式就是LaTeX语法。LaTeX本身就是用普通ASCII字符来描述复杂排版的语言比如\frac{a}{b}表示分数\int_{0}^{1}表示积分。这种纯文本形式天然对网页友好编辑器不会误杀它浏览器也不会误解它。然后还需要一个能在网页上把LaTeX渲染成漂亮公式的引擎最主流的就是MathJax或KaTeX。所以完整链路就变成了从Word公式里提取LaTeX代码粘贴到文章内容中再由WordPress页面加载的MathJax把它渲染成可视化的公式。这篇文章后面所有方案本质上都是围绕这条链路展开。2. 转换公式从 Word 公式到 LaTeX 的可靠方法2.1 为什么要优先学 LaTeX 而非 MathML很多人会问既然浏览器标准里有MathML为什么不把公式转成MathML直接贴理论上可行但实际体验很差。一方面Word虽然支持导出MathML但导出的结构经常带一堆命名空间和多余属性贴到WordPress里还是会被过滤另一方面MathJax虽然也能解析MathML但渲染效果远不如它自己解析LaTeX来得稳定。LaTeX的好处在于它是一种文本语法不受平台绑定也不依赖任何封闭格式它体积小、可读性强、在编辑器里能被直接看到和编辑它还是学术出版领域的事实标准几乎所有公式提取工具、文档转换工具比如Pandoc都优先支持LaTeX输出。所以哪怕你完全没写过LaTeX也值得花二十分钟把最常用的十几个命令记住之后处理公式速度快很多。2.2 MathType 复制 LaTeX最推荐如果你电脑里装了MathType这是最省事的路径。MathType本身就是专业公式编辑器它最大的隐藏技能是可以设置复制格式让公式以LaTeX源码的形式进入剪贴板。我用的操作流程是这样在Word中找到已经写好的公式双击它。如果Word装过MathType插件公式会直接在MathType窗口中打开。打开MathType菜单栏里的“预置”或“Preferences”找到“剪切与复制预置”Cut and Copy Preferences。在弹窗里选择“LaTeX 2.09”或“AMS-LaTeX”那一项。如果版本较新可能还会让你选择是否包含环境信息一般选不含\begin{equation}那种纯公式选项就行。在MathType里CtrlC复制公式。切回WordPress编辑器CtrlV粘贴你会得到类似x\frac{-b\pm\sqrt{b^2-4ac}}{2b}这样的文本。需要注意如果双击Word里的公式打开的是Word自带的公式编辑器而不是MathType说明MathType的加载项没启用。这种情况去“文件-选项-加载项-COM加载项”里把MathType相关项勾选开启。顺带一提还有一个常见问题就是“mathtype如何插入到word中”安装完MathType后Word功能区会出现一个专门的MathType选项卡用它来插入公式才能触发上面的复制转换逻辑。2.3 没有 MathType 时的转换方案没装MathType也不用慌有几个替代路径。公式不多的话手动改写成LaTeX是最直接的。你只需要记住几个高频命令分数是\frac{分子}{分母}上下标是x_{1}和a^{2}根号是\sqrt{...}常用函数像\sin、\log、\lim前面都要加反斜杠积分是\int_{下限}^{上限}。过程确实要花点耐心但公式量不大的时候十几分钟也能搞定一篇。还有一类工具专门做公式OCR识别比如MathPix截图后直接生成LaTeX代码这个我在第四章工作流里会细讲。另外用Word自带的“公式”选项卡把公式转为线性显示也能得到一段线性文本但它是OMML风格的近似表达并不是干净的LaTeX不推荐作为主要方法。3. WordPress 侧公式渲染MathJax 部署指南3.1 MathJax vs KaTeX公式文本进入文章后还需要一个渲染引擎让它变成好看的公式。现在最主流的两个方案是MathJax和KaTeX。MathJax的优势是全面兼容LaTeX语法支持矩阵、多行对齐、各种复杂符号容错能力也强一些。缺点是体积较大首次加载需要下载不少脚本可能影响页面速度。KaTeX则更快更轻渲染效果也很精致但部分高级LaTeX环境支持不全。我的建议如果网站主要发布基础公式、上下标、分式、积分用KaTeX完全够页面速度也好看如果涉及矩阵、分段函数、复杂的多行推导、自定义宏就老实选MathJax。下面是部署MathJax的具体做法这也是我日常使用最多的一套配置。3.2 使用插件快速部署 MathJax最省事的方式是装插件。WordPress插件库里搜索“MathJax-LaTeX”或“Simple Mathjax”安装启用后在设置里配置定界符即可。具体到设置项我一般这样填行内公式定界符启用$...$和\(...\)块级公式定界符启用$$...$$和\[...\]输出格式选SVG而不是HTML-CSS兼容性和缩放更好加载范围只在文章页和页面加载不要在首页、分类页等列表页加载否则全局资源开销太大插件方式适合不熟悉PHP代码的人操作零门槛。但插件偶尔会因为版本更新或与其他插件冲突而失效所以如果是长期维护的站我更建议手动接入。3.3 免插件手动部署 MathJax代码方式手动部署其实就两步把MathJax配置和脚本放进主题的wp_head钩子里。下面这段代码加到当前主题的functions.php文件末尾保存即可function add_mathjax_to_posts() { if ( is_singular() ) { ? script window.MathJax { tex: { inlineMath: [[$, $], [\\(, \\)]], displayMath: [[$$, $$], [\\[, \\]]], processEscapes: true }, options: { skipHtmlTags: [script, noscript, style, textarea, pre, code] } }; /script script srchttps://cdn.jsdelivr.net/npm/mathjax3/es5/tex-chtml.js async/script ?php } } add_action(wp_head, add_mathjax_to_posts);这段代码做了什么我给你拆开说。is_singular()保证只在文章页和页面加载避免全站每个页面都白拉一堆脚本。inlineMath和displayMath定义了MathJax识别公式的定界符$...$和$$...$$是最常用的写法。processEscapes: true允许用\$转义美元符号防止把价格符号误判成公式。skipHtmlTags的意思是HTML标签内部、代码块里的内容不要触发渲染否则你在文章里贴一段代码示例都会被强行渲染成数学公式。3.4 配置里的坑和最佳实践使用这套方案时有几个细节容易踩坑。第一functions.php文件在修改前最好先做备份代码缩进、引号、分号任何一处写错都可能让整个网站白屏。第二如果你用CDN引入MathJax脚本要确认网站是HTTPS环境混合内容会导致脚本被浏览器拦截。第三缓存插件会缓存已渲染的HTML和脚本修改MathJax配置后记得清一次缓存不然你可能看到“改了没生效”。还有一个我个人强烈推荐的做法新配置完成后新建一篇测试文章只放一行公式$\frac{1}{2}$发布后刷新页面确认渲染正常再开始正常发文章。千万别在正式文章里第一次试用MathJax出了问题排查起来很容易混淆。4. 五套从 Word 到 WordPress 的端到端工作流4.1 截图插图片最笨但最稳先讲个最稳妥但不太优雅的方案截图法。在Word里选中公式区域用系统截图工具或微信、QQ的截屏快捷键切下来保存成PNG图片然后在WordPress编辑器中上传插入。公式就变成了一张普通图片绝对能显示不受任何格式兼容问题影响。这个方案适合什么场景一种是公式量极少、每篇文章就那么三五个没必要为了它们折腾太多工具链另一种是公式特别特殊比如有化学结构式、特殊字体符号这类内容LaTeX支持不一定好截图反而最保真。缺点是图片公式不能参与文本搜索也不方便后续修改。如果用户开小窗放大、或者打印时分辨率不够图片会模糊。所以我只把它定位成“兜底方案”而不是日常首选。4.2 MathType 复制 LaTeX推荐日常发布使用日常最推荐的工作流是把MathType的LaTeX复制能力和WordPress的MathJax渲染结合起来。完整操作可以这么走Word里双击公式打开MathType。在MathType里设置复制格式为LaTeX。复制公式。在WordPress编辑器里粘贴。粘贴时建议先切到“代码编辑器”模式避免可视化编辑器干扰。在公式片段前后加上定界符。行内公式用$...$块级公式用$$...$$。发布预览确认渲染效果。这套流程的最大好处是公式以纯文本形式存在于文章内容里完全被WordPress接受后续如果察觉公式有误直接编辑LaTeX代码再改不需要回Word重新截图渲染由MathJax完成措辞质量高知识层面的搜索、复制也能保留公式语义。4.3 MathPix 截图识别Mac 用户和批量场景的首选MathPix这类工具是近几年非常好用的辅助。它通过截图公式图像自动识别并生成LaTeX代码。区别是它可以让完全脱离MathType的绑定尤其适合没装MathType的Mac用户或对方程组、复杂矩阵懒得手敲的场景。操作步骤更简单在Word里把公式截图。打开MathPix粘贴截图。它会立刻识别并输出LaTeX代码。把代码复制到WordPress套上定界符。这类工具对单个公式的识别质量很高包括上下标、根号、求和符号、希腊字母都能比较准地还原。但碰到手写体、低分辨率截图、复杂嵌套括号时偶尔会出错。我的经验是识别完别急着粘贴扫一眼代码里是否出现\quad、\left(这种明显不合理的多余结构顺手清理一下。4.4 Pandoc 批量转换整篇 Word 文档如果手上不是单个公式而是整篇几十页带公式的Word文档手工复制效率太低这时候推荐用Pandoc做批量转换。Pandoc是文档格式转换界的瑞士军刀支持docx、markdown、html、LaTeX等多种格式互转。用它转换后公式会被提取成LaTeX代码插入对应位置。常用的命令是这样pandoc input.docx -o output.md --mathjax--mathjax的作用是让生成的Markdown文件里公式用适合MathJax定界符的方式生成。如果你想得到可以直接粘贴到WordPress的HTML片段可以用pandoc input.docx -o output.html --mathjax然后用浏览器打开output.html复制正文部分粘贴到WordPress代码编辑器里。Pandoc处理过的公式通常已经带好了\(...\)或$$...$$这种定界符粘贴后就能被MathJax识别。这个方案需要你有一点命令行基础但学会之后处理效率极高。我处理过一篇有五十多个公式的Word文档纯手工转得折腾大半天用Pandoc加上人工校验一个多小时就能完成。4.5 在线 LaTeX 编辑器兜底方案最后一个方案更像是一个通用接口如果你只是偶尔发一篇带公式的文章可以直接打开任意一个在线LaTeX公式编辑器很多LaTeX排版网站都带这种工具。在页面里通过图形界面输入公式它会实时生成公式预览同时给出对应的LaTeX代码。把代码复制到WordPress套上定界符结束。这个方案胜在轻便不需要装任何本地软件也不依赖MathType。缺点是效率跟手敲差不多对复杂公式操作起来更费时间。适合用“一次性”场景比如给文章补一个公式或者验证某个LaTeX语法是否正确。5. 常见问题与排查经验实录5.1 公式不渲染的定位流程公式以文本形式显示、没有变成好看的公式这是反馈最多的问题。按顺序排查即可大概率是下面三类原因表现可能原因处理方法LaTeX代码原样显示MathJax脚本没加载检查是否用了is_singular()导致非文章页不加载检查浏览器控制台是否有JS报错反斜杠消失、公式错乱WordPress过滤器转义了反斜杠切到代码编辑器检查源码看\frac是否变成了frac或\\frac剔除冗余转义部分页面能渲染部分不行缓存插件缓存了未渲染的HTML清空插件缓存或给MathJax脚本加版本号参数强制刷新我自己排查时最喜欢用浏览器F12的Console面板。如果加载了MathJax脚本控制台通常能看到MathJax的版本日志如果连日志都没有就说明脚本根本没执行。5.2 粘贴后显示乱码文本的应对从Word直接粘贴偶尔会得到带有大量m:oMath或xmlns字样的XML代码这其实是OMML源码被WordPress当成了普通文本。原因是剪贴板里的OMML层信息没有被剥离干净编辑器又把它当文本输出。处理办法很简单不要直接从Word粘贴到WordPress而是先在系统自带的记事本或任何纯文本编辑器里粘贴一次再复制一遍这样所有隐藏格式都会被清掉粘进WordPress的就是干净的纯文本。然后再手动给公式部分套上LaTeX语法。5.3 加载缓慢与性能优化MathJax脚本体积不小如果用CDN但网络环境不佳页面会出现等待渲染的延迟。我的优化意见分三步走第一步只在需要公式的文章页加载脚本做法就是上文的is_singular()判断第二步如果公式简单把MathJax换成KaTeX后者对基础场景足够用第三步如果整篇内容都是表格和公式可以把公式量极少的页面改用截图方案减少脚本依赖。还有一个小技巧MathJax的SVG输出模式比HTML-CSS模式在复杂公式密集时性能更好也可以在配置里直接指定svg: { fontCache: global }让重复字体缓存在全局共享减少重复渲染成本。5.4 行内公式和块级公式显示不对行内公式和块级公式的判断依赖定界符$...$是行内$$...$$是块级。有些用户发现公式上下跳了一个身位或者字体忽大忽小基本就是定界符用混了。比如你在正文里写“当$x$趋近于0时”如果用了$$x$$公式就会独占一行破坏了语段排版。反过来如果一个复杂的分数公式你想让它居中成块却用了$...$它就会挤在行内导致上下标挤压。所以记住行内用单美元块级用双美元。这是最容易根治的显示问题。5.5 矩阵、多行公式等复杂结构的坑矩阵和多行对齐是踩坑重灾区。原因不是MathJax不支持而是LaTeX环境命令在WordPress的编辑器里偶尔会被清洗或者断行出错。比如一段\begin{pmatrix} ... \end{pmatrix}被编辑器重新换行后内部的空白行可能被过滤掉导致矩阵错位。我的建议是遇到矩阵或分段函数这类复杂结构一律切到代码编辑器模式下粘贴和修改不要停留在可视化编辑器里敲。并且在公式内部不要留空行所有行用\\分隔整个公式写在一段连续的文本里中间不要有回车。这样可以最大限度避免WordPress过滤逻辑“好心办坏事”。里顺便提一个多数人不知道的小细节当你在文章里写了多个$$...$$块级公式MathJax默认会让它们各自独立成块但中间会留白如果想给这两个公式加上编号引用需要额外引入amsmath的equation环境。不过对普通博客来说编号需求不多我一般不加省去不少配置问题。我个人现在处理公式发布文章的固定习惯是先用MathType把公式转为LaTeX如果手头没有MathType就用MathPix截图识别粘贴时只保留纯文本再套上美元定界符WordPress这边用PHP代码在文章页加载MathJax输出配置了SVG渲染。这套流程用了很久稳定性和效率都不错。你如果也经常被Word公式粘贴问题折腾按这套思路走一遍基本能一次理顺还不用回头再改。之后如果遇到特别复杂的多行推导提前把LaTeX语法里的几个环境命令背熟就足够应付绝大多数场景了。
Word公式粘贴到WordPress乱码？转LaTeX+MathJax一步搞定
在Word里辛辛苦苦排好的公式复制粘贴到WordPress后台刷新一看要么变乱码、要么整个公式“凭空消失”这种情况你做WordPress建站或维护博客时大概率碰到过。尤其是有数学、物理、工程内容的站长对这种“公式显示异常”绝对不陌生。我先说结论这跟Word或WordPress哪一段出了bug都没关系本质是“公式格式不兼容”导致的。Word内部用的是自家专用的OMML数学标记语言而WordPress页面只认HTML、CSS和JavaScript能处理的内容。两边互不认识粘贴过去自然水土不服。这篇文章我直接把实操过程串起来给你讲透从Word公式底层格式讲起到公式怎么转成LaTeX再到WordPress里怎么部署MathJax洪染最后给几套可以直接抄的端到端工作流。适合个人站长、教育类博主、科技资讯编辑以及任何需要定期把含公式的文档发布到WordPress的从业者参考。1. 先弄明白Word 公式在 WordPress 里为什么不兼容1.1 Word 公式的底层格式OMML 是座“孤岛”微软在Office 2007之后把数学公式默认存储格式换成了OMMLOffice Math Markup Language。这是一种基于XML的专用标记语言专门描述公式的层级结构、符号位置和排版关系。你随便在Word里插入一个公式比如最简单的二次方程求根公式它在文档底层就是一大段OMML标签。问题是OMML是微软自家的格式。Word能完美解析它是因为Word认识这种结构但浏览器、WordPress编辑器、主流网页脚本都不认识。你把公式从Word里复制出来剪贴板里同时携带了多种格式的数据纯文本、HTML片段、RTF富文本、OMML XML等。粘贴进Word时Word会优先读取OMML那层数据所以看起来“原封不动”。但当目标环境是WordPress的编辑器时编辑器后端不认OMML前端浏览器也不认公式自然就得不到正确解析。1.2 复制粘贴过程中到底发生了什么在Word中复制一个含公式的段落粘贴到WordPress古腾堡编辑器或经典编辑器里这个过程至少会经历两次“格式过滤”。第一次过滤发生在浏览器接收剪贴板数据时。WordPress的编辑器为了安全会剥掉大量它认为不安全的标签OMML标记往往就在被剥掉的范围里。第二次过滤发生在内容保存时。WordPress的wp_kses等过滤机制会再次清洗内容剩下的公式信息就所剩无几了。所以你会看到几种典型表现公式整体消失只留下前后的说明文字公式变成一段看不懂的Xml代码公式变成了图片但图片链接失效或者公式的上下标、根号、分式被拍扁成普通文本。我见过最夸张的情况是一个矩阵公式粘贴后只剩下一堆\begin之类的碎片文本连个完整符号都没留下。1.3 解决思路把“对象”翻译成 LaTeX既然直接粘贴不行就得换思路。数学公式在网页端目前最成熟、兼容性最好的文本表达方式就是LaTeX语法。LaTeX本身就是用普通ASCII字符来描述复杂排版的语言比如\frac{a}{b}表示分数\int_{0}^{1}表示积分。这种纯文本形式天然对网页友好编辑器不会误杀它浏览器也不会误解它。然后还需要一个能在网页上把LaTeX渲染成漂亮公式的引擎最主流的就是MathJax或KaTeX。所以完整链路就变成了从Word公式里提取LaTeX代码粘贴到文章内容中再由WordPress页面加载的MathJax把它渲染成可视化的公式。这篇文章后面所有方案本质上都是围绕这条链路展开。2. 转换公式从 Word 公式到 LaTeX 的可靠方法2.1 为什么要优先学 LaTeX 而非 MathML很多人会问既然浏览器标准里有MathML为什么不把公式转成MathML直接贴理论上可行但实际体验很差。一方面Word虽然支持导出MathML但导出的结构经常带一堆命名空间和多余属性贴到WordPress里还是会被过滤另一方面MathJax虽然也能解析MathML但渲染效果远不如它自己解析LaTeX来得稳定。LaTeX的好处在于它是一种文本语法不受平台绑定也不依赖任何封闭格式它体积小、可读性强、在编辑器里能被直接看到和编辑它还是学术出版领域的事实标准几乎所有公式提取工具、文档转换工具比如Pandoc都优先支持LaTeX输出。所以哪怕你完全没写过LaTeX也值得花二十分钟把最常用的十几个命令记住之后处理公式速度快很多。2.2 MathType 复制 LaTeX最推荐如果你电脑里装了MathType这是最省事的路径。MathType本身就是专业公式编辑器它最大的隐藏技能是可以设置复制格式让公式以LaTeX源码的形式进入剪贴板。我用的操作流程是这样在Word中找到已经写好的公式双击它。如果Word装过MathType插件公式会直接在MathType窗口中打开。打开MathType菜单栏里的“预置”或“Preferences”找到“剪切与复制预置”Cut and Copy Preferences。在弹窗里选择“LaTeX 2.09”或“AMS-LaTeX”那一项。如果版本较新可能还会让你选择是否包含环境信息一般选不含\begin{equation}那种纯公式选项就行。在MathType里CtrlC复制公式。切回WordPress编辑器CtrlV粘贴你会得到类似x\frac{-b\pm\sqrt{b^2-4ac}}{2b}这样的文本。需要注意如果双击Word里的公式打开的是Word自带的公式编辑器而不是MathType说明MathType的加载项没启用。这种情况去“文件-选项-加载项-COM加载项”里把MathType相关项勾选开启。顺带一提还有一个常见问题就是“mathtype如何插入到word中”安装完MathType后Word功能区会出现一个专门的MathType选项卡用它来插入公式才能触发上面的复制转换逻辑。2.3 没有 MathType 时的转换方案没装MathType也不用慌有几个替代路径。公式不多的话手动改写成LaTeX是最直接的。你只需要记住几个高频命令分数是\frac{分子}{分母}上下标是x_{1}和a^{2}根号是\sqrt{...}常用函数像\sin、\log、\lim前面都要加反斜杠积分是\int_{下限}^{上限}。过程确实要花点耐心但公式量不大的时候十几分钟也能搞定一篇。还有一类工具专门做公式OCR识别比如MathPix截图后直接生成LaTeX代码这个我在第四章工作流里会细讲。另外用Word自带的“公式”选项卡把公式转为线性显示也能得到一段线性文本但它是OMML风格的近似表达并不是干净的LaTeX不推荐作为主要方法。3. WordPress 侧公式渲染MathJax 部署指南3.1 MathJax vs KaTeX公式文本进入文章后还需要一个渲染引擎让它变成好看的公式。现在最主流的两个方案是MathJax和KaTeX。MathJax的优势是全面兼容LaTeX语法支持矩阵、多行对齐、各种复杂符号容错能力也强一些。缺点是体积较大首次加载需要下载不少脚本可能影响页面速度。KaTeX则更快更轻渲染效果也很精致但部分高级LaTeX环境支持不全。我的建议如果网站主要发布基础公式、上下标、分式、积分用KaTeX完全够页面速度也好看如果涉及矩阵、分段函数、复杂的多行推导、自定义宏就老实选MathJax。下面是部署MathJax的具体做法这也是我日常使用最多的一套配置。3.2 使用插件快速部署 MathJax最省事的方式是装插件。WordPress插件库里搜索“MathJax-LaTeX”或“Simple Mathjax”安装启用后在设置里配置定界符即可。具体到设置项我一般这样填行内公式定界符启用$...$和\(...\)块级公式定界符启用$$...$$和\[...\]输出格式选SVG而不是HTML-CSS兼容性和缩放更好加载范围只在文章页和页面加载不要在首页、分类页等列表页加载否则全局资源开销太大插件方式适合不熟悉PHP代码的人操作零门槛。但插件偶尔会因为版本更新或与其他插件冲突而失效所以如果是长期维护的站我更建议手动接入。3.3 免插件手动部署 MathJax代码方式手动部署其实就两步把MathJax配置和脚本放进主题的wp_head钩子里。下面这段代码加到当前主题的functions.php文件末尾保存即可function add_mathjax_to_posts() { if ( is_singular() ) { ? script window.MathJax { tex: { inlineMath: [[$, $], [\\(, \\)]], displayMath: [[$$, $$], [\\[, \\]]], processEscapes: true }, options: { skipHtmlTags: [script, noscript, style, textarea, pre, code] } }; /script script srchttps://cdn.jsdelivr.net/npm/mathjax3/es5/tex-chtml.js async/script ?php } } add_action(wp_head, add_mathjax_to_posts);这段代码做了什么我给你拆开说。is_singular()保证只在文章页和页面加载避免全站每个页面都白拉一堆脚本。inlineMath和displayMath定义了MathJax识别公式的定界符$...$和$$...$$是最常用的写法。processEscapes: true允许用\$转义美元符号防止把价格符号误判成公式。skipHtmlTags的意思是HTML标签内部、代码块里的内容不要触发渲染否则你在文章里贴一段代码示例都会被强行渲染成数学公式。3.4 配置里的坑和最佳实践使用这套方案时有几个细节容易踩坑。第一functions.php文件在修改前最好先做备份代码缩进、引号、分号任何一处写错都可能让整个网站白屏。第二如果你用CDN引入MathJax脚本要确认网站是HTTPS环境混合内容会导致脚本被浏览器拦截。第三缓存插件会缓存已渲染的HTML和脚本修改MathJax配置后记得清一次缓存不然你可能看到“改了没生效”。还有一个我个人强烈推荐的做法新配置完成后新建一篇测试文章只放一行公式$\frac{1}{2}$发布后刷新页面确认渲染正常再开始正常发文章。千万别在正式文章里第一次试用MathJax出了问题排查起来很容易混淆。4. 五套从 Word 到 WordPress 的端到端工作流4.1 截图插图片最笨但最稳先讲个最稳妥但不太优雅的方案截图法。在Word里选中公式区域用系统截图工具或微信、QQ的截屏快捷键切下来保存成PNG图片然后在WordPress编辑器中上传插入。公式就变成了一张普通图片绝对能显示不受任何格式兼容问题影响。这个方案适合什么场景一种是公式量极少、每篇文章就那么三五个没必要为了它们折腾太多工具链另一种是公式特别特殊比如有化学结构式、特殊字体符号这类内容LaTeX支持不一定好截图反而最保真。缺点是图片公式不能参与文本搜索也不方便后续修改。如果用户开小窗放大、或者打印时分辨率不够图片会模糊。所以我只把它定位成“兜底方案”而不是日常首选。4.2 MathType 复制 LaTeX推荐日常发布使用日常最推荐的工作流是把MathType的LaTeX复制能力和WordPress的MathJax渲染结合起来。完整操作可以这么走Word里双击公式打开MathType。在MathType里设置复制格式为LaTeX。复制公式。在WordPress编辑器里粘贴。粘贴时建议先切到“代码编辑器”模式避免可视化编辑器干扰。在公式片段前后加上定界符。行内公式用$...$块级公式用$$...$$。发布预览确认渲染效果。这套流程的最大好处是公式以纯文本形式存在于文章内容里完全被WordPress接受后续如果察觉公式有误直接编辑LaTeX代码再改不需要回Word重新截图渲染由MathJax完成措辞质量高知识层面的搜索、复制也能保留公式语义。4.3 MathPix 截图识别Mac 用户和批量场景的首选MathPix这类工具是近几年非常好用的辅助。它通过截图公式图像自动识别并生成LaTeX代码。区别是它可以让完全脱离MathType的绑定尤其适合没装MathType的Mac用户或对方程组、复杂矩阵懒得手敲的场景。操作步骤更简单在Word里把公式截图。打开MathPix粘贴截图。它会立刻识别并输出LaTeX代码。把代码复制到WordPress套上定界符。这类工具对单个公式的识别质量很高包括上下标、根号、求和符号、希腊字母都能比较准地还原。但碰到手写体、低分辨率截图、复杂嵌套括号时偶尔会出错。我的经验是识别完别急着粘贴扫一眼代码里是否出现\quad、\left(这种明显不合理的多余结构顺手清理一下。4.4 Pandoc 批量转换整篇 Word 文档如果手上不是单个公式而是整篇几十页带公式的Word文档手工复制效率太低这时候推荐用Pandoc做批量转换。Pandoc是文档格式转换界的瑞士军刀支持docx、markdown、html、LaTeX等多种格式互转。用它转换后公式会被提取成LaTeX代码插入对应位置。常用的命令是这样pandoc input.docx -o output.md --mathjax--mathjax的作用是让生成的Markdown文件里公式用适合MathJax定界符的方式生成。如果你想得到可以直接粘贴到WordPress的HTML片段可以用pandoc input.docx -o output.html --mathjax然后用浏览器打开output.html复制正文部分粘贴到WordPress代码编辑器里。Pandoc处理过的公式通常已经带好了\(...\)或$$...$$这种定界符粘贴后就能被MathJax识别。这个方案需要你有一点命令行基础但学会之后处理效率极高。我处理过一篇有五十多个公式的Word文档纯手工转得折腾大半天用Pandoc加上人工校验一个多小时就能完成。4.5 在线 LaTeX 编辑器兜底方案最后一个方案更像是一个通用接口如果你只是偶尔发一篇带公式的文章可以直接打开任意一个在线LaTeX公式编辑器很多LaTeX排版网站都带这种工具。在页面里通过图形界面输入公式它会实时生成公式预览同时给出对应的LaTeX代码。把代码复制到WordPress套上定界符结束。这个方案胜在轻便不需要装任何本地软件也不依赖MathType。缺点是效率跟手敲差不多对复杂公式操作起来更费时间。适合用“一次性”场景比如给文章补一个公式或者验证某个LaTeX语法是否正确。5. 常见问题与排查经验实录5.1 公式不渲染的定位流程公式以文本形式显示、没有变成好看的公式这是反馈最多的问题。按顺序排查即可大概率是下面三类原因表现可能原因处理方法LaTeX代码原样显示MathJax脚本没加载检查是否用了is_singular()导致非文章页不加载检查浏览器控制台是否有JS报错反斜杠消失、公式错乱WordPress过滤器转义了反斜杠切到代码编辑器检查源码看\frac是否变成了frac或\\frac剔除冗余转义部分页面能渲染部分不行缓存插件缓存了未渲染的HTML清空插件缓存或给MathJax脚本加版本号参数强制刷新我自己排查时最喜欢用浏览器F12的Console面板。如果加载了MathJax脚本控制台通常能看到MathJax的版本日志如果连日志都没有就说明脚本根本没执行。5.2 粘贴后显示乱码文本的应对从Word直接粘贴偶尔会得到带有大量m:oMath或xmlns字样的XML代码这其实是OMML源码被WordPress当成了普通文本。原因是剪贴板里的OMML层信息没有被剥离干净编辑器又把它当文本输出。处理办法很简单不要直接从Word粘贴到WordPress而是先在系统自带的记事本或任何纯文本编辑器里粘贴一次再复制一遍这样所有隐藏格式都会被清掉粘进WordPress的就是干净的纯文本。然后再手动给公式部分套上LaTeX语法。5.3 加载缓慢与性能优化MathJax脚本体积不小如果用CDN但网络环境不佳页面会出现等待渲染的延迟。我的优化意见分三步走第一步只在需要公式的文章页加载脚本做法就是上文的is_singular()判断第二步如果公式简单把MathJax换成KaTeX后者对基础场景足够用第三步如果整篇内容都是表格和公式可以把公式量极少的页面改用截图方案减少脚本依赖。还有一个小技巧MathJax的SVG输出模式比HTML-CSS模式在复杂公式密集时性能更好也可以在配置里直接指定svg: { fontCache: global }让重复字体缓存在全局共享减少重复渲染成本。5.4 行内公式和块级公式显示不对行内公式和块级公式的判断依赖定界符$...$是行内$$...$$是块级。有些用户发现公式上下跳了一个身位或者字体忽大忽小基本就是定界符用混了。比如你在正文里写“当$x$趋近于0时”如果用了$$x$$公式就会独占一行破坏了语段排版。反过来如果一个复杂的分数公式你想让它居中成块却用了$...$它就会挤在行内导致上下标挤压。所以记住行内用单美元块级用双美元。这是最容易根治的显示问题。5.5 矩阵、多行公式等复杂结构的坑矩阵和多行对齐是踩坑重灾区。原因不是MathJax不支持而是LaTeX环境命令在WordPress的编辑器里偶尔会被清洗或者断行出错。比如一段\begin{pmatrix} ... \end{pmatrix}被编辑器重新换行后内部的空白行可能被过滤掉导致矩阵错位。我的建议是遇到矩阵或分段函数这类复杂结构一律切到代码编辑器模式下粘贴和修改不要停留在可视化编辑器里敲。并且在公式内部不要留空行所有行用\\分隔整个公式写在一段连续的文本里中间不要有回车。这样可以最大限度避免WordPress过滤逻辑“好心办坏事”。里顺便提一个多数人不知道的小细节当你在文章里写了多个$$...$$块级公式MathJax默认会让它们各自独立成块但中间会留白如果想给这两个公式加上编号引用需要额外引入amsmath的equation环境。不过对普通博客来说编号需求不多我一般不加省去不少配置问题。我个人现在处理公式发布文章的固定习惯是先用MathType把公式转为LaTeX如果手头没有MathType就用MathPix截图识别粘贴时只保留纯文本再套上美元定界符WordPress这边用PHP代码在文章页加载MathJax输出配置了SVG渲染。这套流程用了很久稳定性和效率都不错。你如果也经常被Word公式粘贴问题折腾按这套思路走一遍基本能一次理顺还不用回头再改。之后如果遇到特别复杂的多行推导提前把LaTeX语法里的几个环境命令背熟就足够应付绝大多数场景了。
