# How it works

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, Autho](https://help.gocapable.com/jira-markdown/capable-markdown-global-page.html)[Markdown (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-tab](https://help.gocapable.com/jira-markdown/markdown-issue-panel.html)[Markdown 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 markdow](https://help.gocapable.com/jira-markdown/markdown-editor-modal.html)[Editor toolbarFormatting commands: Bold, Italic, Strikethrough, Title (heading), Link, Quote, Code block, Comment, Table, Bulleted list, Numbered list, Insert and Maximize.](https://help.gocapable.com/jira-markdown/editor-toolbar.html)[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.](https://help.gocapable.com/jira-markdown/insert-menu.html)[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 not](https://help.gocapable.com/jira-markdown/templates.html)[Diagrams 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, dbm](https://help.gocapable.com/jira-markdown/diagrams-in-fenced-code-blocks.html)[Images in MarkdownGitHub, GitLab and Bitbucket blob/src links are automatically rewritten to their raw equivalents.](https://help.gocapable.com/jira-markdown/images-in-markdown.html)[Markdown search index (issue entity property)This is what powers the global page and lets people search in JQL.](https://help.gocapable.com/jira-markdown/markdown-search-index-issue-entity-property.html)[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 que](https://help.gocapable.com/jira-markdown/attachment-triggers-and-queue-consumer.html)[Getting 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/.](https://help.gocapable.com/jira-markdown/getting-started-help.html)

---

## Related

[AdministrationWhat an admin controls.](https://help.gocapable.com/jira-markdown/administration.html)

[TroubleshootingWhen it does not.](https://help.gocapable.com/jira-markdown/troubleshooting.html)

---

_How it actually behaves._