mac上obsidian数学公式预览空白、闪烁或显示源码，需从插件启用、语法规范、样式干扰三方面逐层排查：确保设置中「启用数学公式渲染」开启且引擎选mathjax；禁用冲突插件如latex suite；行内用$…$、块级用$$…$$，禁用[]；执行mathjax.typesetclear()和typeset()刷新；若.getcomputedstyle(.math).display为'none'则查css干扰，为'inline-block'则检语法。
Mac上Obsidian数学公式预览空白、闪烁或显示为源码，说明本地MathJax渲染链路未正确建立，需从插件启用、语法规范、样式干扰三方面逐层排查并修复。
确认MathJax渲染引擎已启用
打开Obsidian设置→「外观」→「数学公式」，确保「启用数学公式渲染」开关已打开。该选项在v1.5+版本中为默认内置功能，【若此处关闭，所有公式将完全不解析，仅显示原始LaTeX代码】。
向下滚动至「高级」区域，检查「数学公式渲染引擎」下拉菜单是否选中「MathJax」——不要选KaTeX，除非你明确需要兼容外部导出格式；Obsidian原生MathJax支持更稳定，尤其对多行align、cases等复杂环境。
验证社区插件无冲突
进入设置→「社区插件」→「已启用列表」，确认以下两项状态：
• 「开发者工具」必须启用（用于后续诊断）；
• 「LaTeX Suite」或「Latex2MathJax」等第三方LaTeX增强插件，如与当前公式异常相关，可临时禁用以排除干扰——某些旧版LaTeX Suite会劫持$$解析逻辑，导致MathJax初始化失败。
注意：无需手动安装MathJax脚本，Obsidian v1.5起已将MathJax 3.x深度集成，任何试图通过HTML snippet注入CDN链接的操作反而会引发重复加载报错。
修正公式语法与包裹方式
Obsidian使用Pandoc风格CommonMark扩展解析数学块，对分隔符敏感。请严格按以下规则书写：
• 行内公式：用单个美元符包裹，如 $E = mc^2$；【不可用\(…\)或$ $中间有空格】
• 块级公式：用连续两个美元符包裹，如 $$int_0^infty e^{-x^2}dx = rac{sqrt{pi}}{2}$$；
• 禁止混用：不要在同一个公式中交叉使用$$和[]，Obsidian不支持[]作为块级分隔符（这是MathJax 2.x遗留写法，v3已弃用）。
常见误写：$$egin{aligned}...$$ → 缺少end{aligned}闭合；或使用 rac{a}{b}但未包裹在$$中 → 渲染器直接跳过，当作普通文本。
强制刷新MathJax渲染缓存
第一步：按下 Cmd+Shift+I 打开开发者工具 → 切换到Console标签页；
第二步：输入并回车执行：mathjax.typesetClear(); mathjax.typeset();；
第三步：若控制台报错 mathjax is not defined，说明MathJax未加载成功，返回步骤一检查设置；
第四步：若执行后公式仍不显示，运行：getComputedStyle(document.querySelector('.math')).display；
• 返回值为 'none' → 说明CSS被主题或snippet隐藏，需检查主题配置或禁用自定义CSS；
• 返回值为 'inline-block' → 渲染器已就绪，问题出在公式语法或MathJax内部解析阶段。
排除深色主题导致的公式不可见
方法一：临时切换为Obsidian默认主题（设置→外观→主题→选择「Default」），刷新预览；
方法二：若坚持使用Minimal等第三方主题，打开其设置→「数学公式」选项，确认「启用公式高亮」或「公式背景透明」未被错误开启；
部分深色主题会将.math类文字颜色设为#000000，在黑色背景上完全隐形——此时需在「设置→外观→CSS代码片段」中新建文件，粘贴：
.markdown-preview-view .math { color: var(--text-normal) !important; }
