Keyboard Shortcuts

Quick reference for Noeqtion keyboard shortcuts

Noeqtion provides a convenient keyboard shortcut to trigger equation conversion without leaving your keyboard.

Primary Shortcut

Convert Math Equations

Ctrl + Alt + M

Triggers the conversion process for all LaTeX equations on the current page.

Implementation Details

The keyboard shortcut is implemented using a keydown event listener in the content script:

document.addEventListener("keydown", (event) => {
  if (
    event.ctrlKey &&
    event.altKey &&
    (event.key === "M" || event.key === "m")
  ) {
    event.preventDefault();
    convertMathEquations();
  }
});

The shortcut works with both uppercase and lowercase ‘M’, so you don’t need to worry about Caps Lock.

Shortcut Behavior

1. Event Prevention

   When the shortcut is pressed, event.preventDefault() is called to prevent any default browser behavior from interfering with the conversion process.

2. Immediate Execution

   The convertMathEquations() function is called immediately, starting the conversion process without any delay.

3. Page-Wide Conversion

   The shortcut triggers conversion for ALL equations on the page, not just selected text or the current block.

Platform Support

Windows & Linux

Ctrl + Alt + M

macOS

Ctrl + Alt + M

On macOS, this uses Ctrl (not Cmd). The extension maintains the same shortcut across all platforms.

Alternative Methods

If you prefer not to use the keyboard shortcut, you can also trigger conversion through:

Extension Popup

1. Click Extension Icon

   Click the Noeqtion icon in your browser’s extension toolbar.

2. Press Convert Button

   Click the “Convert” button in the popup window.

The popup method uses the same underlying conversion logic:

// popup.js
document.getElementById('convert-button').addEventListener('click', () => {
  api.tabs.query({ active: true, currentWindow: true }, (tabs) => {
    api.tabs.sendMessage(tabs[0].id, { action: 'convert' });
  });
});

Shortcut Conflicts

If Ctrl+Alt+M is already bound to another extension or application, you may need to disable that binding first.

Common conflicts:

• Some screen recording software
• Window management tools
• Other browser extensions
• System-wide shortcuts on Linux

Future Customization

Currently, the keyboard shortcut is hardcoded in the extension. To change it, you would need to:

1. Edit the content.js file
2. Modify the event listener conditions
3. Reload the extension in your browser

If you need a different shortcut, consider opening an issue on the project repository to request customizable keyboard shortcuts.

Accessibility

The keyboard shortcut provides several accessibility benefits:

• Keyboard-First Workflow: Convert equations without using the mouse
• Visible Feedback: The conversion process provides visual feedback as equations are processed
• Non-Blocking: The shortcut doesn’t interfere with screen readers or other assistive technologies

Troubleshooting Shortcuts

Shortcut Not Working

Possible causes:

• You’re not on a notion.so page
• The content script failed to load
• Another extension is capturing the shortcut first

Solutions:

• Check the browser console for errors
• Disable other extensions temporarily
• Try using the popup method instead

Shortcut Triggers But Nothing Happens

Possible causes:

• No LaTeX equations detected on the page
• Equations are in an unsupported format
• The page structure doesn’t match Notion’s expected DOM

Solutions:

• Verify your equations use $...$ or $$...$$ format
• Check that you’re on a standard Notion page (not a database view)
• Look for console warnings about equation detection

Partial Conversion

If only some equations convert:

• Press the shortcut again to process remaining equations
• Check for KaTeX syntax errors in unconverted equations
• Verify that equations are in editable blocks

Quick Reference

Action	Shortcut	Notes
Convert all equations	Ctrl+Alt+M	Works on focused Notion page
Stop conversion	Esc (during)	Refresh the page to abort
Undo conversion	Ctrl+Z	Use Notion’s native undo