The editor allows you to quickly made changes to several items at once. It is also a convenient way to introduce or change formatting of the items in Markdown WYSIWYG mode.

Use cases, when editor turns to be very useful:

Opening the editor

To open the checklist editor, click the pencil button located in the top-right corner of the Checklist panel:

The editor's content will represent the entire checklist, like in the example below:

 

Content of the editor

Saving the editor's content overwrites the entire checklist for a given issue, so that any changes made in other tabs will be lost.

Features of the editor (toolbar)

Besides manually entering Markdown and other formatting elements, it is possible to use toolbar buttons to quickly bold, italic or strikethrough selected text, toggle item completed or not, add a link, date, separator (header), mention a user, or add emoji.

Bold, Italic, Strikethrough

These basic formatting actions are available directly from the editor's toolbar. Select the word or phrase and click a selected button to apply formatting.

Link

Click a link button in the editor's toolbar and enter the link's label and URL in a dialog. This will generate and insert link's Markdown for you.

Toggle item

Click a toggle checklist item button in the toolbar to mark an item as Done. Click the button once again to reverse the action and uncheck the item.

The table below presents the states of an item when toggled:

Item uncheckedItem checked


* Example



* [x] Example


Toggle if item is optional

Click the toggle optional button (looks like a question mark) in the toolbar to mark an item as optional. Click the button once again to reverse the action and make the item mandatory again.

The table below presents the states of an item when toggled:

Item is mandatoryItem is optional


* Example



* []? Example


Add description

Click a toggle description button in the toolbar to change the current line into an item description (it becomes a description for the preceding item).

The table below presents the states of an item (line) when toggled:

Checklist itemItem description


* Example description



>> Example description


Add separator

Click a separator button in the toolbar to turn an item into separator (header). Click the button once again to turn the separator into a checklist item.

The table below presents the states of an item (line) when toggled:

Checklist itemSeparator (header)


* Example



--- Example


Mention user (user picker)

Click a mention button to insert a "@" token into cursor's current position and open a user picker popup. You can continue typing and click inside the popup to have a complete user mention inserted into an item.

 

Date (calendar picker)

Click a calendar button to insert a "//" token into the cursor's current position and open a calendar popup. You can continue typing or click inside the popup to have a complete date inserted into an item.

Emoji (emoji picker)

Click an emoji button to insert a ":" token into the cursor's current position and open an emoji popup. You can continue typing or click inside the popup to insert an emoji into an item.