Links

Rich text editor

Overview

You can add a description to a ticket using Constructor's rich Markdown-aware text editor. The same editor is also used for discussion comments.
A ticket description is useful for explaining in detail what the ticket is about and what needs to be done to complete it. For example, use it to describe the key behavior of a new feature, to lay out the steps for reproducing a bug, or to link to related artifacts like designs or specs.

Step-by-step

Formatting

Markdown

The editor recognizes basic Markdown syntax formatting:
  • **text** for bold text
  • *text* or _text_ for italic text
  • ~text~ or ~~text~~ for strikethrough text
  • `text` for monospace text / code
  • # , ## , ### , #### , ##### , or ###### at the beginning of a line for headings at different levels
  • > at the beginning of a line for a block quote
  • - or * at the beginning of a line for a bulleted list
  • 1. at the beginning of a line for a numbered list
  • --- at the beginning of a line for a horizontal divider
  • ``` at the beginning of a line, then Enter, for a code block

Keyboard shortcuts

The editor recognizes all of the common formatting keyboard shortcuts you'd expect:
  • Ctrl/Cmd B to toggle bold
  • Ctrl/Cmd I to toggle italics
  • Ctrl/Cmd Shift X to toggle strikethrough
  • Ctrl/Cmd E to toggle monospace text / code
  • Tab while in a list item to indent, and Shift Tab while in a list item to dedent
  • Ctrl/Cmd K to insert a link or make selected text a link
  • Ctrl/Cmd Z to undo and Ctrl/Cmd Shift Z to redo

Adding emoji

You can insert emojis by typing : followed by the emoji's name or alias, such as :+1: or :thumbsup: for
👍
. Or type : and a portion of the emoji's name, then select the emoji you want from the dropdown picker.

Inserting images

To add an image, click the image icon in the toolbar or just drag and drop an image from your computer into the editor area.

Referencing other tickets

You can reference another ticket by typing # followed by the ticket's ID. Or type # and a portion of the ticket's ID, title, labels, etc., then select the ticket from the dropdown picker.