Editor toolbar

Formatting commands: Bold, Italic, Strikethrough, Title (heading), Link, Quote, Code block, Comment, Table, Bulleted list, Numbered list, Insert and Maximize.

Jira Markdown editor showing the formatting toolbar above the source, with bold, italic, strikethrough, heading, link, quote, code, table, list and insert buttons
The formatting toolbar sits above the source in the editor. The view buttons on the right switch between edit, split and preview.

#Worth knowing

There are no toolbar buttons for horizontal rules, inline code, checklists or image upload. Type the Markdown for those directly.


#Where to find it

Editor modal


#Where you do it

Task

Where

Edit a Markdown document

Issue view > Markdown panel > Edit

Add a diagram

Editor > Insert > From code, or write a fenced block yourself

Add an image

Editor > Insert > From web, or plain Markdown image syntax


#Settings that affect this

Setting

Where

What it does

View / Edit (editor mode)

Editor modal

For an existing document, View switches to a read-only preview and Edit switches back to editing. Save only shows while you are editing.

Title

Editor modal

Up to 50 characters. Becomes the attachment's filename.


#A few things that catch people out

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

  • The toolbar has no diagram button. Use Insert > From code, or write a fenced code block yourself.



How it actually behaves.