Skip to content

Getting Started

Installation

From Community Plugins

  1. Open Obsidian Settings → Community plugins
  2. Click Browse and search for "LaTeX Equation Referencer"
  3. Click Install, then Enable

Manual Installation

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create folder: <vault>/.obsidian/plugins/math-booster/
  3. Copy the downloaded files into this folder
  4. Restart Obsidian and enable the plugin

Your First Equation

Step 1: Create a Display Math Block

Write a display math block using $$ delimiters:

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

Step 2: Add an Equation ID

Add a LaTeX comment with a unique ID on a new line before the closing $$:

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
% id: eq-gaussian
$$

ID Format

IDs must start with eq- followed by alphanumeric characters and hyphens. Examples: eq-main, eq-theorem-1, eq-proof-step-2

Step 3: Reference the Equation

Type \eqref to trigger the autocomplete menu, then select your equation:

The Gaussian integral [[#^eq-gaussian]] is fundamental in probability theory.

Step 4: View the Result

The plugin automatically:

  • Adds \tag{1} to number the equation
  • Renders the reference as a clickable link showing (1)
  • Shows a preview popup when you hover over the link

Basic Workflow

graph LR
    A[Write equation] --> B[Add % id: eq-xxx]
    B --> C[Type \eqref]
    C --> D[Select from suggestions]
    D --> E[Link inserted]

Commands

Access these commands via the Command Palette (Ctrl/Cmd + P):

Command Description
Insert display math Insert $$...$$ block with ID template
Search equations in active note Open equation search modal
Fix callout equations in active note Fix indentation in callout math blocks
Export current file to PDF Open PDF export dialog
Insert LaTeX Snippet Insert a saved LaTeX snippet

Next Steps