Callout Support
Use math blocks inside Obsidian callouts with automatic indentation handling.
The Challenge
Obsidian callouts require > prefixes on every line:
Math blocks inside callouts need the same treatment:
Without proper indentation, the math block breaks the callout.
Automatic Handling
The plugin automatically handles callout prefixes when:
- Adding
\tag{}commands - Inserting ID comments
- Managing multi-line equations
Example
Input (with proper prefixes):
After plugin processing:
The plugin preserves the > prefix on all lines.
Fix Command
If your callout equations have broken indentation, use the fix command:
- Open Command Palette (
Ctrl/Cmd + P) - Search for "Fix callout equations in active note"
- Run the command
This scans all math blocks and fixes any incorrect indentation.
What It Fixes
| Before | After |
|---|---|
Missing > on ID line | Adds > prefix |
Missing > on closing $$ | Adds > prefix |
| Inconsistent spacing | Normalizes to > |
Nested Callouts
The plugin supports nested callouts:
The prefix > > is detected and preserved on all lines.
Supported Formats
The plugin recognizes these callout prefix patterns:
| Pattern | Example |
|---|---|
| Standard | > |
| Nested | > > |
| Triple nested | > > > |
| With leading space | > |
Live Preview Behavior
In Live Preview mode:
- The opening
$$line's prefix is detected - All subsequent lines use the same prefix
- The closing
$$line uses the same prefix
This ensures consistent rendering across the entire math block.
Common Issues
Breaking Out of Callout
If your math appears below the callout:
Fix: Add > prefix to the math block lines, or use the fix command.
Missing ID After Fix
If the ID disappears after a fix:
- The ID line may have had invalid characters
- Manually re-add:
> % id: eq-xxx
PDF Export
Callout math blocks export correctly to PDF with:
- Callout styling preserved
- Math rendering intact
- Equation numbers displayed