Skip to main content
Noeqtion automatically detects and converts LaTeX-style equations in your Notion pages to native math blocks. This guide covers everything you need to know to use the extension effectively.

​
Converting Equations

There are two ways to trigger the conversion process:

Keyboard Shortcut

Press Ctrl+Alt+M anywhere on a Notion page

Extension Popup

Click the extension icon and press the “Convert” button

​
Equation Formats

Noeqtion supports two types of LaTeX equations:

​
Inline Equations

Inline equations are wrapped in single dollar signs and appear within text: 
The quadratic formula is $x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$ for any quadratic equation.
Inline equations are converted to Notion’s inline math format using double dollar signs (......).

​
Display Equations

Display equations are wrapped in double dollar signs and appear as block-level elements: 
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
Display equations are converted to Notion’s /math block with the LaTeX content automatically populated.

​
How Conversion Works

1

Detection

The extension scans the page for text nodes matching the equation regex pattern:
/(\$\$[\s\S]*?\$\$|\$[^\$\n]*?\$)/
This pattern matches both inline ($...$) and display ($$...$$) equations.
2

Sequential Processing

Equations are processed one at a time to ensure stability. After each conversion, the DOM is rescanned to find remaining equations.
Sequential processing prevents conflicts and ensures accurate conversion even on pages with many equations.
3

Text Selection

For each equation found, the extension:
  • Locates the editable parent element with data-content-editable-leaf="true"
  • Clicks to focus the block
  • Selects the exact equation text using the DOM Range API
4

Conversion

Based on the equation type:For inline equations:
  • The selected text is replaced with $$latexContent$$
  • Notion automatically renders this as an inline math element
For display equations:
  • The selected text is deleted
  • The /math command is inserted
  • Enter is pressed to create the math block
  • The LaTeX content is inserted into the math block input
  • The “Done” button is clicked (or Escape if there’s an error)
5

DOM Rescan

After a 300ms delay to allow Notion to update the DOM, the page is rescanned for remaining equations.

​
Visual Behavior

During conversion, Noeqtion temporarily hides UI elements to reduce visual distraction: 
/* Math dialog and text action menu are hidden during conversion */
div[role="dialog"] { opacity: 0 !important; transform: scale(0.001) !important; }
.notion-text-action-menu { opacity: 0 !important; }
This creates a smoother experience when converting multiple equations at once.

​
Timing Configuration

The extension uses carefully tuned delays to work with Notion’s UI:
Wait time after focusing an editable block so Notion registers the focus.
Short pause for UI updates between small operations like select/delete/insertText.
Wait for dialogs and inputs to appear (display equations only).
Extra time for the math block to fully initialize (display equations only).
Wait after conversion for Notion to update the DOM before rescanning.

​
Best Practices

Single Page at a Time

Work on one Notion page at a time for best results

Wait for Completion

Let the conversion process finish before editing the page

Valid LaTeX

Ensure your LaTeX syntax is valid before conversion

Save First

Save your work before converting in case you need to undo

​
Example Workflow

Here’s a typical workflow for converting a page with multiple equations:
  1. Paste or type your content with LaTeX equations in Notion
  2. Press Ctrl+Alt+M to start the conversion
  3. Watch as equations are converted one by one
  4. Review the converted math blocks
  5. Edit any equations that need adjustment using Notion’s native math editor
The extension only works on https://www.notion.so/* pages as configured in the manifest.

​
What Gets Converted

The extension converts:
  • ✅ Inline equations: $x^2 + y^2 = z^2$
  • ✅ Display equations: $$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$
  • ✅ Multi-line display equations with \\ line breaks
  • ✅ Complex nested structures like fractions, matrices, and integrals
The extension does NOT convert:
  • ❌ Equations already in Notion’s math block format
  • ❌ Code blocks containing dollar signs
  • ❌ Dollar amounts (e.g., 100or100 or 50.00) - these don’t match the regex pattern

​
Error Handling

If a KaTeX error is detected in the math dialog, the extension automatically closes the dialog with Escape and continues to the next equation.
When conversion fails for an equation, the extension logs a warning and continues processing remaining equations. Check the browser console for detailed error messages.

Build docs developers (and LLMs) love

Get started for freeTalk to us