Marketplace Markdown Guide

When you submit an item to the Marketplace, you can format your item description using Markdown syntax. Markdown is a lightweight markup language with plain text formatting syntax. Its design allows it to be converted to many output formats, including HTML.

Below, you can find the commands that we support for Markdown for Marketplace descriptions.

Headings

Markdown Syntax HTML Output
# h1 Heading <h1>h1 Heading</h1>

h1 Heading

## h2 Heading <h2>h2 Heading</h2>

h2 Heading

### h3 Heading <h3>h3 Heading</h3>

h3 Heading

Emphasis

If more than one markdown syntax is listed, feel free to use any of them. The output will be the same.

Markdown Syntax HTML Output
*italicized text*
_italicized text_
<em>italicized text</em> italicized text
** bold text**
__bold text__
<strong>bold text</strong> bold text
***bold AND italicized text***
___bold AND italicized text___
<strong><em>bold AND italicized text</em></strong> bold text
​~​~​strikethrough~~ <del>strikethrough</del> strikethrough

Line Breaks

To create paragraphs, use a blank line to separate one or more lines of text. You should not indent paragraphs with spaces or tabs.

To create a line break, end a line with two or more spaces, and then hit return.

Markdown Syntax HTML Output
I really like using Markdown.

I think I'll use it to format all of my documents from now on.
<p>I really like using Markdown.</p>
<p>I think I'll use it to format all of my documents from now on.</p>
I really like using Markdown.

I think I'll use it to format all of my documents from now on.
This is the first line.
And this is the second line.
<p>This is the first line.<br>And this is the second line.</p> This is the first line.
And this is the second line.

Blockquotes

To create a blockquote, add a > in front of a paragraph.

> This is a blockquote.

The rendered output looks like this:

This is a blockquote

Blockquotes can contain multiple paragraphs. Add a > on the blank lines between the paragraphs.

> This is a blockquote.
>
> It has a second paragraph.

The rendered output looks like this:

This is a blockquote.

It has a second paragraph.

You can also nest blockquotes:

> This is a blockquote.
>> The second paragraph is nested.

The rendered output looks like this:

This is a blockquote.
The second paragraph is nested.

Lists

To create an ordered list, add line items with numbers followed by periods. The numbers don’t have to be in numerical order, but the list should start with the number one.

To create an unordered list, add dashes (-), asterisks (*), or plus signs (+) in front of line items. Indent one or more items to create a nested list.

Images

Markdown Syntax HTML
![alt text](image.png) <img src="image.png" alt="alt text" />

Code Samples

Markdown Syntax HTML Output
`inline code` <code>inline code</code> Here is some inline code.
```
block
of
code
```
<pre>block
of
code</pre>
block
of
code

Horizontal Rules

If there is more than one markdown syntax listed, feel free to use any of them. The output will be the same.

Markdown Syntax HTML Output
___
---
***
<hr />