Documentation

Learn how to export or convert your Jira issues to clean, portable Markdown directly from the issue view.

01Getting started

Export to Markdown for Jira Cloud lets you export any Jira issue to Markdown — including the description, comments, and fields — with a single click.

i

Before you begin: install the app from the Atlassian Marketplace. Once installed, the export action appears automatically in the issue actions menu — no configuration required. A free 30-day trial is available.

To export an issue, open it and click the three dots in the top-right of the issue, then select Export Markdown.

Jira issue actions menu showing Export Markdown
The Export Markdown action in the issue's Actions menu.

A modal dialog opens with a live preview of your Markdown. Once you're happy with the preview, you can download the result or copy the Markdown to your clipboard.

Export to Markdown modal dialog
The export modal showing a Markdown preview of the issue.

02Export options & settings

From the Options menu in the modal dialog, you can configure how your issue is exported:

Available options
Include comments
Include comments

When enabled, user comments on the issue are included in the exported Markdown.

Include fields
Include work item fields

When enabled, issue fields are included in the generated output — such as status, assignee and components.

Use HTML when required
Use HTML when required

When enabled, HTML is used in the output for content that can't be represented in Markdown — such as underline, superscript and subscript. Disable this if your target tool doesn't support inline HTML.

Export modal with Options menu open
The export dialog showing the Options menu and Markdown preview.

03FAQ

What Markdown flavour does the output use?

The output uses CommonMark-compatible Markdown, which is supported by GitHub, GitLab, Notion, Obsidian, and most other tools. Extended syntax — tables, fenced code blocks with language identifiers — is also included where supported.

Does this work as a Jira to Markdown converter?

Yes — Export to Markdown converts Jira issues to standard Markdown automatically. There is no manual conversion required: open an issue, click Export Markdown, and the converted Markdown is ready to download or copy immediately.

Can I export multiple issues at once?

The app exports one issue at a time from the issue view. To export multiple issues, open each one and use the export action individually.

Which Jira plans does this work with?

Export to Markdown works with all Jira Cloud plans, including Free, Standard, Premium and Enterprise. It is not compatible with Jira Data Center or Server.

Is my data sent to Atly's servers?

No. Export to Markdown is built on Atlassian Forge and runs entirely on Atlassian's own infrastructure. Your content is never sent to or stored on Atly's servers.