Markdown Editor for Jira

Documentation · sellerkit

This app adds a Markdown panel to the Jira work item view. You write the description in plain Markdown; it is saved as native Jira content, so people without the app see a normal, fully formatted description.

Opening the panel

Open any work item. If the panel is not visible yet, use the apps button just under the work item title and choose Markdown. Jira remembers the choice for you from then on.

The first load after an idle period can take several seconds while the app starts up. A blank panel for a moment is normal; it is not an error.

Editing and saving

Before saving, the app re-reads the work item. If somebody else changed the description while you were typing, it asks before overwriting their edit.

Supported syntax

Content Markdown cannot express

Descriptions often contain attachments, panels or macros that have no Markdown syntax. Those are kept exactly as they were, shown in the source as a comment line such as <!-- adf:… -->, and a banner appears at the top of the panel to tell you. Leave those lines alone and the content survives the round trip. Delete a line and that block is removed from the description when you save.

Permissions

The app acts as you. It can only read and change work items your own Jira account may already read and change. If you see a permission message, ask a Jira administrator to check your project permissions.

Privacy

The app stores nothing and sends nothing to any third party. It runs in your browser and talks only to your own Jira site through Atlassian's APIs. See the privacy policy.

Support

Questions, bugs and feature requests: globalmatchhub@gmail.com. We aim to reply within two business days.