atom的markdown-preview-plus插件默认不渲染latex公式，必须手动启用mathjax或katex并配置语法格式（如$...$需空格、$$...$$需空行），且常因math processing delay为0导致公式闪退，调至300以上方可稳定显示。

Atom 的 markdown-preview-plus 插件本身不直接渲染 LaTeX 数学公式，必须配合 MathJax 或 KaTeX 才能显示，且默认配置下几乎必然失败——这是绝大多数人卡住的第一步。

为什么写好 $...$ 但预览里只显示原始符号？

因为插件默认禁用内联数学解析，且未加载任何数学渲染引擎。即使你写了 $E = mc^2$，它也会原样输出，不会转成公式。

• 确认插件已启用：打开 Atom 设置 → Packages → 搜索 markdown-preview-plus → 确保状态为 “Enabled”
• 必须手动开启数学支持：在插件设置页勾选 Enable MathJax（或 Enable KaTeX），二者选其一即可，不要同时开
• MathJax 渲染更兼容但稍慢；KaTeX 更快但对某些宏（如 ewcommand）支持有限
• 若勾选后仍不生效，检查是否被其他插件干扰（如 language-markdown 的旧版本可能冲突）

行内公式和独立公式怎么写才有效？

语法本身遵循标准 Markdown + LaTeX，但需注意空格、换行和包裹方式，markdown-preview-plus 对格式敏感。

Markdown-UI DSL: Zero-Hallucination UI Generation

使用 Markdown-UI DSL 创建低保真文本线框图。

下载

• 行内公式用单美元符：$a^2 + b^2 = c^2$（前后不能紧贴文字，建议加空格：解为 $x=1$。）
• 独立公式用双美元符：$$int_0^infty e^{-x^2} dx = rac{sqrt{pi}}{2}$$，且前后必须是空行
• 避免在公式内使用反斜杠转义 Markdown 符号（如 *），LaTeX 自身已处理；但不要在公式外用 $$ 包裹带星号的列表项
• 如果用了 KaTeX，egin{equation}...end{equation} 不被支持，改用 $$...$$ 或 $...$

自定义宏或字体不生效怎么办？

MathJax 支持配置块，但 markdown-preview-plus 不读取外部 mathjax-config.js，只能通过插件设置页的 MathJax Configuration 文本框注入。

• 在插件设置中找到 MathJax Configuration 字段，填入合法 JSON（不是 JavaScript）：

• {
    "tex": {
      "macros": {
        "R": "{\mathbb{R}}",
        "abs": ["{\lvert #1 \rvert}", 1]
      }
    }
  }

• 注意：JSON 中键名必须用双引号，函数参数占位符用 #1，不是 $1
• 修改后需重启预览窗口（关闭再打开 Markdown Preview 标签页），热重载不生效
• KaTeX 不支持运行时宏定义，如需自定义命令，只能选 MathJax

最常被忽略的是：插件设置里「Math Processing Delay」默认为 0，而 MathJax 初始化需要时间，尤其首次加载。如果公式闪一下就变回源码，把该值调到 300 以上再试。