Using Markdown

HackerOne supports markdown syntax on reports, profiles, and security pages.


Markdown Input:

A First Level Header

A Second Level Header

### Header 3




Markdown Input:

>text in blockquote
>more text in blockquote



Text emphasis

Markdown Input:

*This text is italicized*
_This text is underlined_
**This text is bold**
__This text is bold__
~~This text is deleted~~
==This text is highlighted==

Output: text emphasis output


Unordered Lists

Markdown Input:

* Candy.
* Gum.
* Juice.


+ Candy.
+ Gum.
+ Juice.

and this:

- Candy
- Gum.
- Juice.

all produce the same output:

unordered list

Numbered Lists

Markdown Input:

1. Red
2. Green
3. Blue


ordered list

If you put blank lines between items, you’ll get <p> tags for the list item text. You can create multi-paragraph list items by indenting the paragraphs by 4 spaces or 1 tab:

* A list item.

  With multiple paragraphs.

* Another item in the list.


Markdown supports two styles for creating links: inline and reference. With both styles, you use square brackets to delimit the text you want to turn into a link.

Inline-style links use parentheses immediately after the link text. For example:

Markdown Input:

This is an [example link](



Optionally, you may include a title attribute in the parentheses. Hover on the link to see the title:

This is an [example link]( "With a Title").

This is an example link.

Reference-style links allow you to refer to your links by names, which you define elsewhere in your document:

Markdown Input:

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]:        "Google"
[2]:  "Yahoo Search"
[3]:    "MSN Search"


multiple links

The title attribute is optional. Link names may contain letters, numbers and spaces, but are not case sensitive:

Markdown Input:

I start my morning with a cup of coffee and
[The New York Times][NY Times].

[ny times]:


ny times link

You don't need to use markdown to create a mailto: link. Simply enter the email as is and it will automatically be converted to a mailto: link.


In a regular paragraph, you can create code span by wrapping text in back tick quotes. Any ampersands (&) and angle brackets (< or >) will automatically be translated into HTML entities. This makes it easy to use Markdown to write about HTML example code.

Markdown Input:

The text has sample `code`



To specify an entire block of pre-formatted code, wrap the text within 3 back tick quotes ```. Just like with code spans, &, <, and > characters will be escaped automatically.

Markdown Input:

codeblock input


codeblock output

To use syntax highlighting, specify the content type after the three opening back tick quotes.

Markdown Input:

document.location = '';


markdown code syntax

Go to the following web page to see which content types are available for syntax highlighting:

User mentions

You can mention a user by prefixing username with '@' symbol

Markdown Input:

@demo-member reported the issue


markdown user mention

Report reference

You can reference a report by prefixing report id with '#' symbol

#105887 is a publicly disclosed bug

#105887 is a publicly disclosed bug

Attachment references

You can reference an attachment while writing reports, comments in reports and report summary. You can do this by writing 'F' followed by attachment id (F). The attachment id is displayed before the attachment name once the upload is successful.

Example: Consider a user is creating a report and uploads an attachment. Once the attachment is uploaded successfully, you will see see the reference id with the attachment name. markdown-1

Now you can reference the attachment in the report by writing 'F1' and the attachment is referenced in the report as shown below. markdown-2

When the link is clicked, the attachment is displayed in the modal. markdown-3

Inline images and video

You can inline images and videos in the report description, comments and report summary by writing the attachment reference id within curly braces (as in {F:id}).

Example: For the above attachment, the markdown:

 Here is an inlined image of an apple {F1}

will render the following: