# Insert Markdown from Git

📝

Add Markdown files from your Git repositories to Confluence or Jira.

![Embed Markdown in Confluence from Github](https://help.gocapable.com/images/2a9bae8c-1c10-4b22-b9db-84a1fc6e02f1.webp)

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

* Connect your GitHub account (and ensure org approval/SSO if required).
* Confirm you have access to the repository and branch containing the file.

### [#](#supported-formats)Supported formats

* `.md`, `.markdown`, `.mdx`

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

1. In your page or work item, insert the Github File macro

![Insert Markdown in Confluence from Github](https://help.gocapable.com/images/f1fdbbf5-4d92-40a0-800e-012f06f8e1df.webp)

1. If prompted, connect your Git account and select the correct account.
2. Search or browse to the repository, then pick the branch.

![Browse Github repositories](https://help.gocapable.com/images/75ed4a0f-4554-4073-9225-18feeea784e7.webp)

1. Navigate folders and select the Markdown file.

![Insert markdown from Github](https://help.gocapable.com/images/1fd333fe-e5fa-4e43-8d5a-03dbaa68748c.webp)

1. (Optional) Edit the title shown above the content.
2. Insert to add the Markdown to your page/work item.

### [#](#how-it-renders)How it renders

* Markdown is rendered as rich content including headings, lists, links, code blocks, and tables.
* Images referenced with absolute URLs will display; private images require accessible URLs.

### [#](#permissions)Permissions

* Viewers must have their own access to the repository. If they don’t, they’ll be prompted to connect or will see an access error.

### [#](#troubleshooting)Troubleshooting

* File not listed: Check the selected account, branch, and repository permissions.
* Images don’t show: Ensure the image path is publicly accessible or embedded as an inline image in the page.