Does Jira Cloud support Markdown? The precise answer

Updated 18 August 2026

The honest answer is partly, and not in the way most people mean. Jira Cloud will convert some Markdown while you type it, but it never stores Markdown, and it has no mode where you edit an issue as a plain Markdown document.

What Jira Cloud actually stores

Jira Cloud keeps rich content in Atlassian Document Format (ADF): a JSON tree of nodes, not text. A heading is not the characters ## Title; it is a heading node with a level. Nothing you type is kept as Markdown, so there is no "show me the Markdown source" view to switch to.

This one fact explains almost every surprise below.

What does work: autoformatting as you type

The Cloud editor watches your keystrokes and swaps recognised patterns for real nodes. Type ## and a space and you get a heading: but what is saved is the heading node, and the characters you typed are gone.

This is input assistance. It fires on the pattern you are typing at that moment.

What does not work

• Pasting a Markdown document. Autoformatting reacts to typing, so a block of Markdown arriving at once does not get the same treatment. See pasting Markdown into Jira.
• Round-tripping. You cannot open an existing description as Markdown, edit it, and save it back. There is nothing to open: the description is ADF.
• Wiki markup. That is the Server and Data Center syntax (h1., {code}), and it is a different language from Markdown. The Cloud editor does not accept it.

Is Atlassian going to add it?

There is a long-running request for a plain Markdown editor, JRACLOUD-72631. As of 18 August 2026 it has 1,742 votes and 509 watchers, it was filed in July 2019, and its status is Future Consideration: Atlassian's label for "not on the roadmap, may be revisited". So this is worth planning around rather than waiting on.

If you just want to write Markdown

• Lean on autoformatting. If you type your issues rather than paste them, most of Markdown's everyday syntax already converts. The cheat sheet lists what is recognised.
• Convert before pasting. Render your Markdown somewhere and paste the rendered result: see converting Markdown for Jira.
• Use an editor app. Marketplace apps add a Markdown panel to the issue view. Ours is one of them.