Skip to content →

Markdown editor

Issue descriptions and comments support Markdown.

Linear app showing the create issue modal with formatting options


We support most Markdown elements in our text editor. Type in Markdown or paste it directly and it will be converted into rich text automatically.

Read more about Markdown and access full capabilities here.

You can also apply styling with a toolbar, which will pop up after you highlight a word or phrase or using slash commands when typing /.

See below for keyboard shortcuts or search specific ones with ?


Text styling

These styles can be applied using keyboard shortcuts or by highlighting text to bring up a styling toolbar. You can also hit / on your keyboard to bring up the formatting options:

  • **text** or Cmd/Ctrl B for bold text
  • _text_ or Cmd/Ctrl I or Cmd/Ctrl > for italicized text
  • ~~text~~ or Cmd/Ctrl S to strikethrough text
  • *, -, or then space or Cmd/Ctrl Shift 8 for a bulleted list
  • 1. or Cmd/Ctrl Shift 9 for a numbered list
  • [] or Cmd/Ctrl Shift 7 for a checklist
  • > then Space for blockquotes
  • Cmd/Ctrl K Turn text into link (or directly paste issue or URLs for clickable links)
  • # then Space Heading 1
  • ## then Space Heading 2
  • ### then Space Heading 3
  • Cmd/Ctrl U for underlined text
  • Cmd/Ctrl E for inline code
  • Code or Cmd/Ctrl Shift \\ for a code block
  • ___ then space for a horizontal divider
  • /table to create a table element
  • /file or /inset to attach files

Use Cmd A to select all content if you need to delete an improperly formatted table.

Helpful commands

  • Cmd/Ctrl A to select all content in an issue (to copy or delete)
  • Cmd/Ctrl Z to undo typing
  • Cmd/Ctrl Shift Z to redo typing
  • Cmd Shift U to attach an image or file
  • Copy the issue description in Markdown by opening the command menu (Cmd/Ctrl K) when viewing the issue and selecting the command copy issue in markdown
  • Shift Enter to generate a line break
  • Enter Enter to break out of codeblock or blockquote formatting


Add emojis to descriptions or comments with our native emoji picker or by typing : followed by the emoji name, such as :100: for 💯 and :+1: for 👍 .


Write @text to mention a user, issue, project or document in a description or comment. For users, this will send a notification to their Inbox and subscribe them to the issue. We only support single user mentions at the moment, not user groups.

Pasting the issue issue ID will also link it in the editor. Referenced issues are added as related issues automatically.