Add specs, notes and runbooks to Jira work items in Markdown, with a live preview, 17 templates and diagrams in code blocks. Each document is saved on the issue as a .md file.
Works inside
Cloud
Built on Atlassian Forge
Documents are .md attachments on the issue, under your Jira permissions.
How it worksNothing shown to anonymous viewers
The panel and the documents list are only shown to people signed in to Jira.
Anonymous viewersCapable is used by teams at
Jira has no macros, so Markdown gets its own panel on the issue and its own page under Apps.
The panel shows one tab per Markdown document on the issue, with a rendered preview, and Edit, Add, Sort and Delete controls. Pin it to show on every work item.
Write with the source and a live preview side by side, a formatting toolbar and an Insert menu. Start from a template such as Checklist, API Documentation or Release notes.
A fenced block in Mermaid, PlantUML, Graphviz, D2 or any of 27 diagram languages renders as a picture inside the document.
The Capable Markdown page under Apps lists Markdown documents across your projects with their work item, author, date and size, and a project filter.
A story with its spec written in Markdown. Pick a number, or take the tour.
The editor works like this: Markdown on the left, the rendered document on the right. Pick a sample or start typing.
One order, and a clear message about the timeout.
Two orders are created. See the retry flow:
sequenceDiagram
App->>API: POST /orders
API--xApp: timeout
App->>API: POST /orders (retry)
API-->>App: 201 CreatedIn Jira, open the Markdown panel on a work item, choose Add and write or paste this in.
Try it in Jira, freeExcerpts from public reviews on the Atlassian Marketplace.
This app gave us exactly what we needed - markdown in our Jira tickets. It is easy to use and the UI is clear and functional. … The support experience was excellent as the response came within 20 minutes!
| Job | Today | With Markdown |
|---|---|---|
| Structured descriptions | Long specs and runbooks squeezed into the issue description. | Separate Markdown documents on the issue, each with its own tab, title and preview.Source: What Capable Markdown for Jira is |
| Content from other tools | Markdown from a repository reformatted by hand for Jira. | Paste the Markdown into the editor and it renders as written, tables and code blocks included.Source: Markdown editor |
| Finding documents later | Notes spread across tickets, with no way to see them together. | One page under Apps lists every Markdown document across your projects.Source: Capable Markdown global page |
Install Markdown for Jira from the Atlassian Marketplace and approve its permissions.
Get startedOn a work item, open the apps button under the summary and choose Markdown.
Markdown issue panelChoose Add, give it a title, start from a template if you like, and save. It’s attached to the issue as a .md file.
Markdown editorShort, current pages from help.gocapable.com.
Each answer links to the page it comes from.
Open the apps button under the work item summary and choose Markdown to add the panel. Then choose Add, write or pick a template, and save.
Source: Markdown issue panel
As .md attachments on the issue. The panel shows one tab per .md attachment, including files attached through Jira’s own attachment control. Deleting a tab deletes the attachment.
Source: How it works
Seventeen built-in starters in three folders, including Checklist, Blog post, FAQ, Tutorial, API Documentation, Architecture Design, Process flow, Release notes and Meeting notes. Picking one replaces whatever is in the editor.
Source: Templates
Yes. A fenced code block in one of 27 diagram languages, such as Mermaid, PlantUML, Graphviz or D2, renders as an image through Capable’s hosted diagram service for signed-in readers.
Source: Diagrams in fenced code blocks
By URL. There’s no image upload from the editor, and relative image paths inside a document can’t resolve in Jira.
Source: Markdown editor
No. The Capable suite is Confluence-only, and Markdown for Jira is its own app. It has no macros, version history or AI drafting: those belong to the Confluence side.
Source: What is not available
Install Markdown for Jira from the Atlassian Marketplace and add the Markdown panel to a work item.
