LaTeX Delimiter Renderer

An Obsidian plugin that renders standard LaTeX \(…\) and \[…\] math delimiters alongside Obsidian's native $…$ and $$…$$ syntax. Automatic and without rewriting your Markdown files.

Features

• Renders \(x + 1\) as inline math.
• Renders \[x + 1\] as display math, including multiline equations.
• Works in Live Preview and Reading View.
• Preserves native heading folding in both views.
• Reveals the complete original source when a rendered formula is clicked or the cursor enters it.
• Prevents LaTeX subscripts from leaking Markdown emphasis into surrounding prose.
• Leaves inline code and fenced code blocks untouched.
• Uses Obsidian's bundled MathJax renderer and works offline.

Usage

Write math using either LaTeX delimiter style:

Inline: \( E = mc^2 \)

Display:
\[
E = mc^2
\]

Rendering is automatic. There are no commands or per-note settings.

Installation

Community Plugins

Once accepted into the Obsidian Community Plugins directory, search for LaTeX Delimiter Renderer under Settings → Community plugins → Browse.

BRAT

1. Install the BRAT community plugin.
2. Choose Add beta plugin.
3. Enter https://github.com/BurgerAndreas/latex-delimiter-renderer.

Manual

Download main.js, manifest.json, and styles.css from the latest GitHub release and place them in:

<vault>/.obsidian/plugins/latex-delimiter-renderer/

Reload Obsidian, then enable LaTeX Delimiter Renderer under Community plugins.

Limitations

• Multiline \(…\) expressions remain unrendered because inline editor decorations cannot safely span lines.
• In Live Preview, multiline \[…\] expressions must occupy complete lines.
• Reading View replaces only matched delimiter text in the rendered DOM. The source file is never modified.

Privacy and security

This plugin:

• does not access the network;
• does not collect analytics or telemetry;
• does not require an account or payment;
• does not read or write files outside Obsidian's normal rendering process;
• does not modify note contents.

Development

npm install
npm run check

The production bundle is written to main.js.

Release assets include signed GitHub build-provenance attestations. Verify a downloaded asset with:

gh attestation verify main.js -R BurgerAndreas/latex-delimiter-renderer

License

MIT