MathMacro

MathMacro

MathMacro is a small Obsidian plugin that brings a WordMat-style input experience to math and physics writing.

Instead of making you type LaTeX manually, it helps you enter common notation more quickly inside Obsidian math fields.

Features

• Alt + M inserts a centered display math block ($$ ... $$) and places the cursor inside it.
• Press Space inside a math field to trigger WordMat-style shortcuts.
• Supported shortcuts include:
  • / -> \frac{a}{b} for simple fractions like 1/2
  • ^ -> superscripts like v^{2}
  • _ -> subscripts like F_{c}
  • * -> \cdot
  • \alpha, \beta, \gamma, \theta, \omega, \pi
  • \sqrt, \int, \sum, \vec, \hat

Installation

1. Download the latest release from the Obsidian Community Plugins page or from the GitHub releases for this repository.
2. Copy the plugin folder into your vault's .obsidian/plugins/obsmat directory.
3. Reload Obsidian and enable MathMacro in Community Plugins.

Usage

1. Open a note in Obsidian.
2. Press Alt + M to insert a math field.
3. Type a shortcut inside the math field.
4. Press Space to expand it into normal Markdown / LaTeX.

Examples:

• 1/2 + Space -> \frac{1}{2}
• v^2 + Space -> v^{2}
• F_c + Space -> F_{c}
• * + Space -> \cdot
• \sqrt + Space -> \sqrt{}

Development

npm install
npm run build

The build output is main.js, which Obsidian loads from the plugin folder.

Compatibility

• Requires Obsidian 1.5.0 or newer.
• Compatible with desktop and mobile Obsidian.
• The input shortcuts are native for keyboard, but also work on mobile keyboard.

Project goals

MathMacro is intentionally small and focused.

It is meant to improve math and physics input in Obsidian without turning into a full LaTeX editor or equation tool.

License

All rights reserved. See LICENSE for the full terms.