Markdown editor modal

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

Opens 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 markdown: <title>'.

The Add Markdown modal with a title field reading Tutorial, a templates dropdown, a formatting toolbar, Markdown source on the left and the rendered preview on the right.
The editor opens over the work item with the Markdown source on the left and a live preview on the right.

#Worth knowing

Save hands the title and body back to the panel, which writes the .md attachment. Close discards the draft.

#Where to find it

Issue view > Markdown panel > Add or Edit

#DefaultState

Opens in live mode (source and preview side by side) for a new document.

#Where you do it

Task

Where

Make the Markdown panel always visible on issues

Jira project settings > Issue layout

Add a Markdown document to an issue

Issue view > Markdown panel > Add

Read a Markdown document

Issue view > Markdown panel

#Settings that affect this

Setting

Where

What it does

Sort tabs

Issue view > Markdown panel > sort button

-

Getting started / List view

Apps > Capable Markdown > two icon buttons in the header

-

Project filter

Apps > Capable Markdown > project selector

-

#Worth knowing

  • Relative image paths inside a document cannot resolve, because the Jira panel and modal pass no base URL or content id to the renderer.

  • There is no image upload from the editor. Images must be referenced by URL.

  • Deleting a Markdown tab permanently deletes the underlying Jira attachment.

How it actually behaves.