Pages lets you create and modify your marketplace’s content pages. The text in these pages can be formatted using Markdown. This guide provides an introduction to Markdown to help you use it when formatting your content pages. To learn more about editing pages in general, read our How to edit Pages article.

Markdown is a simple markup language used to add formatting to text. If you want to emphasize a part of the content of your Pages, you can do so by formatting the text of your sections and blocks. In practice, Markdown adds basic formatting tags to the underlying code of your page. It doesn’t do anything fancy like changing the font size, font color, or font family — but it covers the essentials, using simple keyboard symbols.

The Pages feature uses a modified version of Markdown syntax. It allows you to add bold, italics, links, lists, headers, code and quotation blocks to the content text. You can only add Markdown to text in Content Blocks. Markdown doesn’t work in section titles, section descriptions or block titles.

This article helps you get an idea of how markdown works. Bear in mind that the rendering in this site is different from the rendering in Pages. The results from using markdown in Pages will not look exactly the same as what you can see here.

You can highlight the text with italics, bold or a combination of both. You can do so by adding asterisks or underlines to the text. See the examples for reference:

This is italic text and this is also italics text
This is bold text and this is also bold text
This is bold and italics text and so is this text

You can add different levels of headers by adding hashes to the beginning of the text. The number of hash signs determines the heading level:

It is possible to add h1 and h2 headings to the content via markdown. You simply need to follow a similar format. We recommend avoiding doing it, though! A page should only have a single h1 header, which can be added directly through the Page editor to the first title in your page. The h2 can then be added either through the Section or the Block titles.

You can add links to the text by adding square brackets, followed by the link in parenthesis:

Linking to pages within your marketplace site should be done with internal links for faster page loads:

You can also turn a URL into a link by surrounding it with <>:

You can display a text as a clickable link that opens the user's default email program and creates a new email:

You can create ordered or unordered lists.

To create unordered lists, you can use different symbols: plus signs, dashes or asterisks.

To create ordered lists, you can use numbers. The first number of the list will determine the starting number of the rendered version of the list. The other numbers do not matter.

43. First item

44. Second item

45. Third item

You can also have indented lists by adding four spaces before the list item

You can add quotation blocks to your content by adding the greater than sign (>) before a paragraph:

You can also create nested quotation blocks

Lastly, you can use most other formatting symbols inside quotations in order to create more complex quotation blocks.

You can add code blocks to your content. Most marketplaces will not need to add code blocks for coding-related reasons, however, code blocks and code formatting are effective methods for highlighting text.

You can create inline code by using backticks. For example

You can create blocks of code by using backtick fences which is code surrounded by three backticks (```). For example:

You will, of course, notice that we've been creating blocks of code for the entire article to highlight the markdown code.

You can divide the text with a horizontal line by adding 3 dashes, 3 asterisks or 3 underscores.

It would look something like this

You will notice that in this article itself the sections are separated by similar lines.

You can add new lines within a paragraph by adding the \ character at the end of the line. For example:

You can show an image already configured/hosted on your marketplace (for example in Branding, or in a page social & SEO tags, or a listing image). Because of safety reasons, it isn't possible to show an image hosted somewhere else than on your marketplace.

"Alt text" is a free text that describe your image, and which will be used for accessibility and search engines.

You can even make the image clickable (opens in a new tab), by combining the Markdown for images with the Markdown for links.

You can “escape” automatic formatting by adding a backspace (\) before the asterisks, hashes, dashes and other symbols used in markdown. This will allow you to display the symbol on the rendered page instead of triggering a specific formatting rule.

There are formatting limitations with Markdown. Line breaks are particularly tricky. No matter how many spaces you add in between paragraphs, the paragraphs will always be separated by the same amount of space.

There are a few additional supported formatting rules with Markdown that would allow you to create the same results as above but with different symbols. This article doesn’t cover those cases to allow for simpler usage definitions.

Finally, Pages support much of the Markdown syntax but not everything. If you want to learn more about Markdown syntax, you can visit the official Markdown documentation or the Markdown extended syntax guide.
​