# What Capable Markdown for Jira is

The app adds exactly two things you can see: a "Markdown" panel on the issue view, which shows one tab per .md attachment with a rendered preview plus Add, Edit, Delete and sort controls, and a "Capable Markdown" global page under Apps, which lists Markdown documents across projects.

Behind those it also keeps a small per-issue search index (so the global page can find issues that hold Markdown) and two attachment triggers that maintain it.

The editor is a full-screen modal with a live side-by-side Markdown editor, a formatting toolbar, 17 built-in templates and support for fenced diagram code blocks (mermaid, plantuml, graphviz, d2 and 23 others) that render as images through Capable's hosted service.

---

## At a glance

![A Jira work item with the Capable Markdown panel open, showing tabs for User Journey and Architecture Design, a rendered software architecture document, and Edit and Add buttons.](https://help.gocapable.com/images/843bde3e-c0dc-446c-82d5-d98b9ef21195.webp)

The panel sits below the description on the work item, with one tab for each Markdown document attached to it.

---

## How to show the panel

![Close-up of a Jira work item header with the apps button open and a small menu listing Markdown and Add apps.](https://help.gocapable.com/images/844300f7-0fe4-4958-8dff-b32aa54d4133.webp)

The apps button beneath the work item summary lists Markdown, which puts the panel on that work item.

---

## Related

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

[Capable for ConfluenceThe suite.](https://staging.dev.capable-sites.com/wiki/pages/1412890864)

---

_The short version._