What is Live Preview?
Live Preview provides instant visual feedback as you write LaTeX equations. See your mathematical expressions render in real-time without having to save or publish your changes.
Key Features
- β‘ Real-time Rendering - See changes instantly as you type
- π¨ Split-Pane Editor - Code on left, preview on right
- π Auto-Update - Preview updates automatically
- π― Syntax Validation - Immediate error feedback
- π± Responsive Design - Works on all screen sizes
How Live Preview Works
Editor Layout
The Split-Pane Interface
Left Pane: LaTeX Editor- Syntax-highlighted code editor
- Write and edit LaTeX code
- Auto-completion for common commands
- Line numbers for easy navigation
- Real-time rendered output
- Shows exactly how your equation will appear
- Alignment controls (left/center/right)
- Instant error messages
Using Live Preview
Opening the Editor
- Insert a LaTeX macro on your page
- The editor opens automatically with live preview
- Start typing your LaTeX code
- Watch the preview update in real-time
Writing Equations
As you type:Editing Existing Equations
- Click on any LaTeX macro
- The editor opens with your existing code
- Make changes in the left pane
- Preview updates automatically
- Click Save when satisfied
Preview Features
Alignment Preview
Test different alignments in real-time: Left Align- Click the left align button
- Preview updates immediately
- Equation aligns to left margin
- Click the center align button
- Preview centers the equation
- Most common for display equations
- Click the right align button
- Preview aligns to right margin
- Useful for specific formatting needs
Error Detection
The preview helps catch errors immediately: Syntax Error:Resizable Panes
Adjusting Pane Width
- Hover over the divider between panes
- Drag left or right to resize
- Release when satisfied
- 50/50 split (default)
- 60/40 (more code space)
- 40/60 (more preview space)
π‘ Tip: Give more space to the pane youβre focusing on.
Editor Shortcuts
Keyboard Shortcuts
Editor Features
Auto-Indentation- Automatic code formatting
- Proper nesting for environments
- Commands highlighted in color
- Easier to spot errors
- Matching braces highlighted
- Helps balance parentheses
Formula Library Integration
Quick Insert
While editing, access the formula library:- Click βFormula Libraryβ button (π)
- Browse common equations
- Click any formula to insert
- Preview updates with new content
Categories
- Greek Letters
- Common Formulas
- Calculus
- Linear Algebra
- Statistics
- Physics
- Chemistry
Best Practices
β Doβs
- Use the preview - Verify rendering before saving
- Test alignment - Try different alignments
- Check for errors - Watch for error messages
- Adjust pane sizes - Optimize for your workflow
- Save frequently - Donβt lose your work
β Donβts
- Donβt ignore errors - Fix syntax issues before saving
- Donβt rush - Take time to verify output
- Donβt close without saving - Youβll lose changes
- Donβt overcomplicate - Keep LaTeX simple when possible
Preview Limitations
What Preview Shows
β Final rendered appearance β Alignment β Font size relative to page β Dark/light mode β Error messagesWhat Preview Doesnβt Show
β Exact page context β Surrounding Confluence content β How it looks in different browsers β Mobile view (use responsive preview)Note: Always preview the full page after saving to see the equation in context.
Troubleshooting
Preview Not Updating
Problem: Changes donβt appear in preview Solutions:- Wait a moment - thereβs a small delay
- Check for syntax errors
- Try typing in a different part of the code
- Refresh the editor (close and reopen)
Preview Shows Error
Problem: Red error message in preview Solutions:- Read the error message carefully
- Check for:
- Missing closing braces
} - Unbalanced delimiters
- Typos in command names
- Unsupported commands
- Missing closing braces
- Fix the error and preview updates
Panes Wonβt Resize
Problem: Canβt drag the divider Solutions:- Ensure youβre hovering over the divider
- Try clicking and dragging again
- Refresh the page
- Use a different browser
Preview is Blank
Problem: Right pane shows nothing Solutions:- Check if youβve entered any LaTeX code
- Verify code has valid delimiters
- Look for syntax errors
- Try entering a simple equation:
E = mc^2
Performance Tips
For Smooth Preview
- β Keep equations reasonably sized
- β Avoid extremely complex nested structures
- β Use proper LaTeX syntax
- β οΈ Very large matrices may render slowly
- β οΈ Excessive nesting impacts performance
Editor Performance
The live preview is optimized for:- Up to 500 lines of LaTeX code
- Equations with up to 50 elements
- Matrices up to 10Γ10
- Preview may have slight delay
- Consider breaking into multiple macros
- Simplify where possible
Mobile Experience
Tablet View
- Split-pane layout maintained
- Panes stack vertically in portrait mode
- Horizontal scroll for wide equations
- Touch-friendly controls
Phone View
- Editor and preview in tabs
- Swipe to switch between views
- Full-width editing
- Save button always visible
Advanced Tips
1. Quick Testing
Use the preview to test LaTeX commands:2. Learning LaTeX
The preview is a great learning tool:- Type commands
- See results immediately
- Learn by experimenting
3. Debugging
Use preview to isolate errors:- Comment out sections
- Find the problematic line
- Fix and verify
4. Comparing Approaches
Test different LaTeX approaches:Accessibility
Screen Reader Support
- Editor announces changes
- Error messages are read aloud
- Keyboard navigation supported
High Contrast Mode
- Preview respects system settings
- Adequate contrast maintained
- Clear visual separation
Related Documentation
- π Inline Macro - Inline equations
- π Block Macro - Display equations
- π Dark Mode - Theme support
- β FAQ
Need Help?
- π¬ Contact Support
- π View All Documentation
- π₯ Video Tutorial (Coming Soon)
