Data Migration

This article covers how to move macro content between pages, export diagrams and equations as images, what happens when the app is uninstalled, and how to migrate from other diagram tools.

---

Copying Macro Content Between Pages

Using the Copy Source Button

The easiest way to reuse macro content on another page:

1. View the published page containing the macro you want to copy
2. Hover over the rendered macro to reveal the hover toolbar
3. Click Copy Source - the raw Mermaid code or LaTeX is copied to your clipboard
4. Navigate to the destination page and open it in edit mode
5. Insert the appropriate macro type (Diagrams, LaTeX Block, or LaTeX Inline)
6. Paste the copied source into the Source panel
7. Confirm it renders correctly in the Preview panel
8. Click Save, then Publish the page

Copying an Entire Page

Because macro content is stored in the Confluence page storage format:

• Using Confluence's Copy page feature copies all macros and their content along with the page
• The copied page will have the same diagrams and equations as the original
• Each macro can then be independently edited on the copied page

---

Exporting Diagrams as PNG or SVG

From the Fullscreen Viewer

1. View the published page
2. Hover over a Diagrams macro and click Fullscreen
3. In the fullscreen overlay, right-click on the rendered diagram
4. Select Save image as... (PNG) or Copy image to use it elsewhere

For LaTeX Equations

1. View the published page
2. Hover over a LaTeX Block macro and click Fullscreen
3. Right-click the rendered equation and save as image

Tip: For higher-quality exports, zoom in before capturing the image. The rendered output is vector-based (SVG internally) so it scales cleanly.

---

What Happens When the App Is Uninstalled

When a Confluence administrator uninstalls LaTeX Formulas & Diagrams:

Key point: Uninstalling the app does not destroy your content. Your Mermaid and LaTeX source remains in the page. Reinstalling the app restores full rendering.

---

Migrating from Other Diagram Tools

Migrating from PlantUML

PlantUML and Mermaid are different diagramming languages. Direct syntax conversion is not automatic.

Migration approach for PlantUML:

1. Export or copy the PlantUML source from your existing tool
2. Identify the diagram type
3. Rewrite using the equivalent Mermaid syntax (use the Samples dropdown for starting templates)
4. Test in the Diagrams macro editor Preview panel before saving

Comparison with draw.io (diagrams.net)

When to choose LaTeX Formulas & Diagrams over draw.io:

• Your team is comfortable writing Mermaid or LaTeX
• You need exact, reproducible diagrams from code (version-controlled source)
• You need mathematical formulas alongside diagrams
• You prefer text-based authoring that can be diffed in page history