# How to insert markdown

📝

Learn how to insert Markdown in Jira work items.

## [#](#1-open-a-jira-work-item)1\. Open a Jira work item

Open a Jira work item.

## [#](#2-click-on-the-apps-icon-and-select-markdown)2\. Click on the ‘Apps’ icon and select ‘Markdown’

Click on the Apps icon that is just under the Jira work item summary.

![Screenshot 2025-09-09 at 10.15.03.png](https://help.gocapable.com/images/67f85219-4d50-4e7f-b757-86ed7f7a45ed.webp)

## [#](#3-click-add-markdown)3\. Click ‘Add markdown’

Click on the ‘Add markdown’ button in the markdown panel.

![Screenshot 2025-09-09 at 10.15.58.png](https://help.gocapable.com/images/61cc6142-7786-4ec2-8253-a3a50dac110c.webp)

## [#](#4-create-your-markdown-and-click-insert)4\. Create your Markdown and click insert

Choose the markdown you’d like to use.

![Screenshot 2025-09-09 at 10.16.34.png](https://help.gocapable.com/images/b3f56412-2bed-4183-a6d9-eb72a47b4c02.webp)

You can use templates that are included in the app from the templates dropdown:

![Screenshot 2025-09-09 at 10.16.48.png](https://help.gocapable.com/images/969447a8-aef0-4299-a1dd-14709d214ceb.webp)

## [#](#5-optional-make-the-panel-show-on-all-jira-work-items)5\. (optional) Make the panel show on all Jira work items

Click on ‘Show for all work items’ to make the Markdown panel show on Jira issues by default.

![Screenshot 2025-09-09 at 10.17.18.png](https://help.gocapable.com/images/bca4307e-c9ce-429c-a6dc-901ce0f07a3e.webp)