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.

Headings	Paragraphs
`1 2 3 4 5 6# Heading 1 ## Heading 2 ### Heading 3 ### Heading 4 #### Heading 5 #### Heading 6`	`1 2 3 4 5 6Each 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 4Italic 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 61. Step 1 2. Step 2 3. Step 3 a. Step 2a b. Step 2b c. Step 2c`	`1 2 3 4 5 61. Step 1 2. Step 2 3. Step 3 * Item 2a * Item 2b * Item 3c`	`1 2 3 4 5Introducing my quote: > Neque porro quisquam est qui > dolorem ipsum quia dolor sit amet, > consectetur, adipisci velit...`
	Make sure you indent sub-lists 4 spaces.

Character Styles

Unordered List

Ordered List

List in List

Quotes or Citations

*Italic characters* 
_Italic characters_
**bold characters**
__bold characters__

* Item 1
* Item 2
* Item 3
  * Item 2a
  * Item 2b
  * Item 3c

1. Step 1
2. Step 2
3. Step 3
  a. Step 2a
  b. Step 2b
  c. Step 2c

1. Step 1
2. Step 2
3. Step 3
  * Item 2a
  * Item 2b
  * Item 3c

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 3This 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

Object	Syntax	Example
pull request	`1pull request #PR_NUMBER`
issues	`1issue #ISSUE_NUMBER`	`1issue #3`
commit 7-40 chars	`1HEX_CHARS`	`1bb21047`

Object

Syntax

Example

pull request

pull request #PR_NUMBER

issues

issue #ISSUE_NUMBER

issue #3

commit

7-40 chars

HEX_CHARS

bb21047

Linking to non-repository objects

Object	Syntax	Example
user (account)	`1@USERNAME`	`1@tutorials`
Emoji David Coffey created a list of available emoji.	`1:EMOJI:`	`1:mask:`

Object

Syntax

Example

user (account)

@USERNAME

@tutorials

Emoji

David Coffey created a list of available emoji.

:EMOJI:

: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.

Was this helpful?

It wasn't accurate

It wasn't clear

It wasn't relevant

Still need help?

The Atlassian Community is here for you.

Ask the Community