# Insert Diagrams from Git

📝

Render text-based diagrams stored in your repositories directly on a page or work item.

![Embedded Diagram from Github in Confluence](https://help.gocapable.com/images/548535ae-3f52-474d-a60c-dee5e2a499a6.webp)

### [#](#before-you-start)Before you start

* Connect your Git account and ensure you can access the target repository.
* Confirm the diagram file contains valid syntax (e.g., Mermaid, PlantUML).

### [#](#commonly-supported-formats)Commonly supported formats

* Mermaid: `.mermaid`, `.mmd`
* PlantUML: `.plantuml`, `.puml`
* Graphviz/DOT: `.dot`, `.gv`
* D2: `.d2`, DBML: `.dbml`, Excalidraw: `.excalidraw`, BPMN: `.bpmn`
* Blockdiag family: `.blockdiag`, `.actdiag`, `.seqdiag`, `.packetdiag`, `.nwdiag`, `.rackdiag`
* Vega/Vega-Lite: `.vega.json`, `.vegalite.json`

### [#](#insert-steps)Insert steps

1. Insert the Github File macro

![Insert Github File Macro](https://help.gocapable.com/images/d0a5b481-0e12-4d7d-a39e-3765f2b420df.webp)

1. Connect/select your account and pick the repository and branch.

![Browse Github from Confluence](https://help.gocapable.com/images/22df47c4-9c50-45d5-a669-4c2f1214c1f6.webp)

1. Browse to your diagram file and select it.

![Browse Github from Confluence](https://help.gocapable.com/images/d39a2813-784d-422f-8cd5-02d7b58f9182.webp)

1. Preview and set the display title.

![Insert diagrams from Github in Confluence pages](https://help.gocapable.com/images/91300dc5-e680-4498-af6f-c495f60f9323.webp)

1. Insert to render the diagram.

![Diagrams from Github in Confluence pages](https://help.gocapable.com/images/e246dbfa-dcfe-4328-bc54-fea922a79648.webp)

### [#](#rendering-tips)Rendering tips

* Ensure the file’s syntax is valid; invalid content may show as text or an error.
* Large or complex diagrams may take longer to render.

### [#](#permissions)Permissions

* Each viewer must have access to the repository to see the rendered diagram.

### [#](#troubleshooting)Troubleshooting

* Diagram won’t render: Validate syntax locally, then refresh.
* File not found: Verify the selected branch and path.