🎉 Overview

LaTeX Macro Migrator is a powerful tool that helps you analyze latex macro usage across your Confluence instance and seamlessly migrate from third-party latex apps to Easy Latex Math

🔍 Pre-Migration Checklist

Before migrating, ensure you've completed the following:

[ ] Reviewed the limitations document
[ ] Verified source macro type is supported
[ ] Tested migration on a single page first
[ ] Have access to page history for rollback if needed
[ ] Noted pages with complex formulas for manual verification
[ ] Scheduled migration during low-traffic period (for bulk migrations)
[ ] Browser console is open for monitoring progress/errors

📋 Post-Migration Verification

After migration, verify the following:

[ ] Latex formulas render correctly
[ ] Parameters (font size, color, alignment) are preserved
[ ] Equation numbering (for mathblock) works as expected
[ ] Page version history shows migration entry
[ ] No console errors related to macro rendering
[ ] Test pages display correctly across different browsers

Migration Steps

Step 0: Install Easy LaTeX Math for Confluence and LaTeX Macro Migrator apps

Step 1: Go to the Macro Migration toolbar Apps → LaTeX Macro Migrator

Step 2: Select Source App and source macro key (and space)

Step 3: Click on Get Usage Statistics button to get the macro usage results

Step 4: Migrate the old app macros to Easy LaTeX Math

a. To migrate a specific page click on the button adjacent to the page

b. To migrate all the macros of a specific space click on Migrate All adjacent to the space summary row

Migrated pages will be displayed in green

🚀 Best Practices

1. Test First

Always test migration on a single, non-critical page before bulk migration.

2. Backup Content

While Confluence maintains version history, consider exporting important spaces before migration.

3. Communicate Changes

Inform your team before performing large-scale migrations to avoid confusion.

4. Monitor Progress

Keep browser console open during migrations to catch errors early.

5. Verify Rendering

Spot-check migrated pages to ensure formulas render correctly.

6. Plan for Downtime

For large spaces (>100 pages), plan migration during off-hours to minimize impact.

7. Document Custom Configurations

Note any custom macro configurations before migration for reference.

📝 Known Issues

Migration is limited to supported macros only (see limitations document)
Large-scale migrations (>100 pages) may take time due to sequential processing
Some parameter mappings may not be 1:1 (see limitations document)

📞 Support & Assistance

If you encounter issues not covered in this document please reach out to SilverTek Technologies support with:

Source app and macro type
Example page storage format
Steps to reproduce the issue

Migrate Third Party LaTeX Apps to Easy LaTeX Math