# Get started

Browse repositories, select files, and render Markdown, diagrams, images, and other files directly on your pages:

* Insert Markdown from Git (richly rendered)
* Insert Diagrams from Git (Mermaid, PlantUML, DOT, and more)
* Insert Images from Git (PNG, JPG, SVG, etc.)
* Insert Other Files from Git (code with syntax highlighting, config, markup, plain text)

[Install Capable →](https://marketplace.atlassian.com/vendors/1223389/capable)

![Code from Github to Confluence](https://help.gocapable.com/images/6493d991-712f-4c2c-8eac-2821cfdecee4.webp)

---

## How it works

* Each user connects their own GitHub account. Access is never shared between users.
* Content renders only for viewers who have access to the referenced repo/branch/file.
* Organization approval or SSO may be required by your GitHub org. If prompted, complete the approval or SSO flow.

---

## Getting started

1. Open a Confluence page and insert the Github file macro

![Insert Code from Github to Confluence](https://help.gocapable.com/images/57966172-efa1-4d0f-910d-4f2ad1985850.webp)

1. Connect your GitHub account when prompted (complete org approval/SSO if required).

![Browse Github repositories in Confluence](https://help.gocapable.com/images/8432a74c-a2c8-4662-999d-69e631895f06.webp)

1. Pick a repository and branch, then select the file you want to embed.

![Browse Github repositories in Confluence](https://help.gocapable.com/images/75cfa3b0-8322-42bd-a759-029d70eb5f76.webp)

1. Adjust the title or display options and insert it into your page.

![Embed Diagrams from Github in Confluence](https://help.gocapable.com/images/5bdf85d4-2dce-4ba1-9a36-c66f133c4e71.webp)

1. All done!

![Embedded Diagram from Github in Confluence](https://help.gocapable.com/images/31f29a6c-5883-48b6-bc8d-ea5ba7ea1cab.webp)

---

## In this section

[Common tasksThe 12 things people actually do with GitHub, and where each one lives.](https://help.gocapable.com/git/common-tasks.html)

---

## Related

[How it worksThe behaviour.](https://help.gocapable.com/git/how-it-works.html)

[ReferenceLimits and gaps.](https://help.gocapable.com/git/reference.html)

---

_Start from the task._