在Sublime Text中配置Markdown MathJax数学公式渲染的方法

P粉328763957

P粉328763957

2026-07-14

720人浏览

原创

必须安装官方 markdownpreview 插件并配置 mathjax v2.7.9 cdn,行内公式用 $e=mc^2$、块级公式用 $$\int_0^\infty e^{-x}dx = 1$$,且必须通过浏览器预览(ctrl+shift+p → preview in browser),侧边栏不执行 js,公式永不渲染。

在sublime text中配置markdown mathjax数学公式渲染的方法

必须用 MarkdownPreview,别装 Markdown Preview Plus

Sublime Text 里没有官方或主流维护的 Markdown Preview Plus 插件——你搜到的多半是拼写错误、过时 fork 或个人魔改版。它不支持 MathJax,配置了也白搭。enable_mathjax 字段会被忽略,预览永远显示 $E=mc^2$ 而不是渲染结果。

正确做法是:

  • 卸载所有名称含 Preview PlusEnhanced Plus 的插件
  • 通过 Package Control → Install Package → 搜索并安装 MarkdownPreview(作者:facelessuser
  • 安装后检查 Packages/MarkdownPreview/ 目录下是否存在 js/math_config.js,没有说明安装不完整

MathJax 必须用 v2.7.9 CDN,v3 地址直接失效

MarkdownPreview v3.0.x 硬编码依赖 MathJax v2,用 v3 的 CDN(比如 https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js)会导致控制台报 ReferenceError: MathJax is not defined,公式块彻底空白。

Settings – User 中必须写死这一行:

"mathjax CDN": "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/MathJax.js?config=TeX-AMS_HTML"

注意两点:

Sublime Text Build Linux版
Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载
  • 不能省略 ?config=TeX-AMS_HTML —— 这是启用 \begin{aligned} 和基础 LaTeX 命令的关键参数
  • 本地离线部署不可行:插件未提供 MathJax 本地路径支持,硬改 JS 会因路径解析失败而静默跳过

公式语法容错率极低,空格和下划线就是致命点

MathJax v2.7.9 只稳定支持 TeX-AMS_HTML 配置下的语法,不是所有 LaTeX 写法都可用。常见“写了但不显示”,往往是因为被当成纯文本吞掉了:

  • 行内公式必须写成 $E=mc^2$$ E = mc^2 $(含空格)❌
  • 块级公式必须写成 $$\int_0^\infty e^{-x}dx = 1$$,前后不能有字符(比如 $$$$. $$ ❌)
  • 下划线必须转义:a_b ❌ → a\_b
  • 大括号要用 \lbrace/\rbrace\left\{/\right\},原生 {a+b} 不识别
  • 多行对齐只认 \begin{aligned}...\end{aligned}\begin{align} 默认不启用

预览必须走浏览器,侧边栏永远不渲染公式

这是最常被忽略的致命点:Preview in Sidebar 是纯 HTML 渲染器,不执行任何 JS,MathJax.js 根本不会下载。你看到的 $$\int_0^\infty$$ 就是源码原样输出,不是“没配好”,而是压根没触发解析流程。

唯一有效路径是:

  • Ctrl+Shift+P → 输入 Markdown Preview: Preview in Browser
  • 或右键文件 → Open Preview in Browser(效果相同,且自动刷新)
  • 浏览器地址栏应显示 file:/// 路径;开发者工具 Network 标签页能看到 MathJax.js 请求成功
  • Chrome/Edge 用户需关闭 chrome://settings/privacy 中的“使用预测服务加载网页”,否则本地 file:// 协议会被拦截

真正卡住人的地方,往往不是配置错,而是盯着侧边栏看半天,其实连 MathJax 的请求都没发出去。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
li是什么元素
li是什么元素

li是HTML标记语言中的一个元素,用于创建列表。li代表列表项,它是ul或ol的子元素,li标签的作用是定义列表中的每个项目。本专题为大家li元素相关的各种文章、以及下载和课程。

2023.08.03

596

5

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

10

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

7

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

10

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

4

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

1

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

3

10

火山引擎对象存储使用教程
火山引擎对象存储使用教程

火山引擎对象存储适合用于网站图片、视频文件、备份数据、静态资源和应用附件管理。本专题整理TOS控制台入口、存储桶创建、地域选择、权限设置、文件上传、访问链接生成、CDN加速、费用查看和常见上传或访问失败问题,帮助用户快速掌握对象存储基础操作。

2026.08.04

1

10

火山引擎云服务器使用教程
火山引擎云服务器使用教程

火山引擎云服务器使用教程适合第一次购买、部署和管理云服务器的用户参考。本专题整理控制台入口、实例创建、地域和配置选择、系统镜像设置、安全组放行、远程连接、网站部署、续费计费和常见连接失败问题,帮助用户快速完成云服务器基础使用流程。

2026.08.04

5

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程