# Usage

Excalidraw Plus for Confluence is a powerful macro app that brings the collaborative diagramming capabilities of Excalidraw directly into your Confluence pages.

## Getting Started[​](#getting-started "Direct link to Getting Started")

### Installation[​](#installation "Direct link to Installation")

1. Log in to your Confluence instance as an admin
2. Go to the Atlassian Marketplace
3. Search for "Excalidraw Plus for Confluence"
4. Click "Get app" or "Try it free"
5. Follow the installation wizard instructions

### Adding Excalidraw to Your Page[​](#adding-excalidraw-to-your-page "Direct link to Adding Excalidraw to Your Page")

There are two ways to add an Excalidraw diagram:

1. Using the toolbar:

   * Click the `+` button in your Confluence editor
   * Search for "Excalidraw Plus"
   * Click to insert the macro

2. Using the slash command:

   * Type `/` in your Confluence editor
   * Type "Excalidraw"
   * Press Enter

## Core Features[​](#core-features "Direct link to Core Features")

### Drawing Tools[​](#drawing-tools "Direct link to Drawing Tools")

* **Shapes**: Rectangle, Circle, Diamond, Arrow, Line
* **Freehand Drawing**: Pencil tool for sketching
* **Text**: Add text annotations and labels
* **Library**: Pre-made components and shapes

### Styling Options[​](#styling-options "Direct link to Styling Options")

* **Colors**: Custom color picker for fills and strokes
* **Line Styles**: Solid, dashed, dotted
* **Text Formatting**: Font size, alignment, and style
* **Opacity**: Adjust transparency of elements

## Working with Diagrams[​](#working-with-diagrams "Direct link to Working with Diagrams")

### Saving Your Work[​](#saving-your-work "Direct link to Saving Your Work")

The diagram automatically saves as you work. To ensure all changes are preserved:

1. Click outside the Excalidraw editor
2. Save the Confluence page
3. Wait for the sync confirmation

### Viewing Results[​](#viewing-results "Direct link to Viewing Results")

Your diagrams will appear:

* In view mode of the Confluence page
* In PDF exports
* In page previews

### Export Options[​](#export-options "Direct link to Export Options")

1. Click the menu icon (⋮) in the Excalidraw editor

2. Choose from multiple export formats:

   <!-- -->

   * PNG
   * SVG
   * JSON (for backup)

## Tips and Best Practices[​](#tips-and-best-practices "Direct link to Tips and Best Practices")

* Use the grid feature for precise alignment
* Group related elements together
* Leverage the library for consistent diagrams
* Save frequently used components to your library

## Related Blog Posts[​](#related-blog-posts "Direct link to Related Blog Posts")

* [Excalidraw for Confluence & Jira: FAQ, Tips & Best Practices](/blog/faq-excalidraw-best-practices.md)
* [Excalidraw for Confluence — Which Whiteboard App Fits Your Team?](/blog/use-excalidraw-in-confluence-whiteboard-diagrams.md)
* [Confluence diagram tools compared: Mermaid vs Excalidraw vs Graphviz](/blog/confluence-diagram-tools-comparison.md)
* [How to Add Excalidraw Whiteboards to Jira Issues](/blog/excalidraw-whiteboards-jira.md)

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

If you encounter issues:

1. Refresh the page
2. Clear browser cache
3. Contact support through the Marketplace listing

## Support and Resources[​](#support-and-resources "Direct link to Support and Resources")

* [Official Documentation](https://excalidraw.com/docs)
* [Community Forum](https://community.atlassian.com)
* [Video Tutorials](https://youtube.com/excalidraw)
* [NGPilot Service](mailto:service@ngpilot.com)

Was this helpful?👍 Yes👎 No