Highlight syntax and mark up issues

Syntax highlighting and markup in the issue tracker is Markdown syntax just as it is with comments in Bitbucket Cloud.

Markdown Cheat Sheet

The tables below contain examples of the most common Markdown syntax.  You can use the format bar in a comment to format text or you can type Markdown directly.To play with the syntax, go ahead and copy one of the examples below and paste it into a Bitbucket comment or issue. For a full list of all the Markdown syntax, go to John Gruber's Daring Fireball site get a complete list of Markdown syntax.



1 2 3 4 5 6 # Heading 1 ## Heading 2 ### Heading 3 ### Heading 4 #### Heading 5 #### Heading 6
1 2 3 4 5 6 Each sentence is on its own line the press return for a newline line. To break a line, type two spaces after the line ends and then press the new line.  For example, this is one

Character Styles

Unordered List

Ordered List

List in List

Quotes or Citations

1 2 3 4 *Italic characters* _Italic characters_ **bold characters** __bold characters__
1 2 3 4 5 6 * Item 1 * Item 2 * Item 3 * Item 2a * Item 2b * Item 3c
1 2 3 4 5 6 1. Step 1 2. Step 2 3. Step 3 a. Step 2a b. Step 2b c. Step 2c
1 2 3 4 5 6 1. Step 1 2. Step 2 3. Step 3 * Item 2a * Item 2b * Item 3c



1 2 3 4 5 Introducing my quote:   > Neque porro quisquam est qui  > dolorem ipsum quia dolor sit amet,  > consectetur, adipisci velit...


Make sure you indent sub-lists 4 spaces.


Code Characters

Links to External Websites

Link to a Wiki Page

1 2 3 Use the backtick to refer to a `function()`.   There is a literal ``backtick (`)`` here.


1 2 ``` Use three backticks (or indent four spaces) to invoke a code block
1 2 3 This is [an example](http://www.slate.com/ "Title") inline link. [This link](http://example.net/) has no title attribute.
1 [Home](Home)

Referencing Bitbucket Cloud Objects in Issues

You can also refer to Bitbucket issues, requests, and users directly from a comment, issue, or commit message.  When you create a reference, saving the comment (or issue) causes Bitbucket to automatically link to that object.  For items that relate to a repo, such as issues, pull requests, and commits, markdown references to Bitbucket objects always refer to the current repository.  You can also mention an individual or team account, or even insert an emoji.

Linking to objects for comments and issues within a repository




pull request

1 pull request #PR_NUMBER




1 issue #3


7-40 chars


1 bb21047

Linking to non-repository objects




user (account)

1 @tutorials


David Coffey created a list of available emoji

1 :mask:

Finally, if you have created a link to Jira or another service such as Jenkins, you can enter references for those "linkers" too.  For information on creating and using linkers, see Link to a web service.


Additional Help