MathJax Rendering Error: Commands Like `\oiint` Not Recognized

Help
1

MathJax Rendering Error: Commands Like \oiint Not Recognized

Environment Information

  • Obsidian Version: v1.9.12
  • Operating System: Windows 11

Issue Description

When using commands such as \oiint and \oiiint within mathematical formulas inserted via $$...$$ in Obsidian notes, MathJax fails to render these symbols correctly. Instead, they are displayed with a yellow background and red text, indicating an error.

Reproduction Steps

Commands That Fail to Render

In a new or existing note, input the following block:

Surface Integral: $$\oiint\limits_{S}$$
Volume Integral: $$\oiiint\limits_{V}$$

Actual Result

Surface Integral: $$\oiint\limits_{S}$$
Volume Integral: $$\oiiint\limits_{V}$$

屏幕截图 2025-09-14 004832
屏幕截图 2025-09-14 004832995×312 12 KB

Expected Result

The formulas should be rendered correctly as their corresponding mathematical symbols:

  • \oiint should display as the double closed surface integral symbol: ∯
  • \oiiint should display as the triple closed volume integral symbol: ∰

Analysis & Suggestions

According to the MathJax documentation, commands like \oiint and \oiiint are supported (see: MathJax: New and Updated Macros).
However, for unknown reasons, they are not functioning within Obsidian.

Additional Information

  • This issue persists regardless of whether multiple themes or community plugins are enabled or disabled, suggesting the root cause lies in Obsidian’s built-in MathJax configuration.
  • Relevant References:
2

We are still using mathjax 3.2 and won’t update to mathjax 4 for while.

3
4

those commands work decently in displaystyle ($$...$$) but not inline ($...$). for the latter, one workaround is to use the unicode symbols ∯ and ∰ directly.

one could use \mathchoice in the command definition to switch automatically.

5

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.