How it works

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

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

#In this section

Capable Markdown (global page)A cross-project browser for Markdown. The header reads 'Capable Markdown for Jira'. It shows an item count, a project filter, a Getting started / List view toggle, and a table of Markdown attachments with columns Name, Issue, Summary, AuthoMarkdown (issue panel)The main working surface. One tab per .md attachment on the issue (overflow tabs collapse into a 'More (n)' menu), a read-only rendered preview of the selected tab at a fixed 500px height, plus Sort tabs, Edit and Add buttons and a per-tabMarkdown editor modalOpens at maximum size with navigation hidden. Contains a Title field, a Templates dropdown, a View/Edit toggle, the formatting toolbar, an Insert menu, and Save and Close buttons. Add uses the heading 'Add Markdown'; Edit uses 'Edit markdowEditor toolbarFormatting commands: Bold, Italic, Strikethrough, Title (heading), Link, Quote, Code block, Comment, Table, Bulleted list, Numbered list, Insert and Maximize.Insert menu'From web' inserts an image reference to a Capable illustration. 'From code' inserts a ready-made mermaid 'graph TD' fenced block to start a diagram.TemplatesInserts one of 17 built-in Markdown starters, grouped into three folders. General purpose: Checklist, Blog post, FAQ, Tutorial. Project Planning: Process flow, Product requirements, Project proposal, User journey, Release notes, Meeting notDiagrams in fenced code blocksA fenced code block written in one of 27 supported diagram languages is rendered as an SVG image by Capable's hosted diagram service. Supported: blockdiag, bpmn, bytefield, seqdiag, actdiag, nwdiag, packetdiag, rackdiag, c4plantuml, d2, dbmImages in MarkdownGitHub, GitLab and Bitbucket blob/src links are automatically rewritten to their raw equivalents.Markdown search index (issue entity property)This is what powers the global page and lets people search in JQL.Attachment triggers and queue consumerListens for attachment created and attachment deleted events, recounts the .md attachments on the affected issue and updates the search index. Two install/upgrade triggers also run for bootstrap. The work is dispatched through the app's queGetting started helpShows five help cards. How to insert markdown, How to browse markdown, Embed diagrams in markdown, Always show markdown panel, How to download markdown. Plus a 'View full documentation' button to https://help.gocapable.com/jira-markdown/.

How it actually behaves.