Use the markdown web part

When you add a modern page to a site, you add and customize web parts, which are the building blocks of your page. This article focuses on the Markdown web part.

The Markdown web part allows you to add text to your page and format it using Markdown language.

Notes: 

• Some functionality is introduced gradually to organizations that have opted in to the Targeted Release program. This means that you may not yet see this feature or it may look different than what is described in the help articles.

• The Markdown web part is not available in SharePoint Server 2019.

Add the Markdown web part

1. Go to the page where you want to add the Markdown web part.

2. If your page is not already in edit mode, click Edit at the top right of the page.

   Hover your mouse above or below an existing web part and you'll see a line with a circled +, like this:

   

3. Click +, and then search for and select Markdown from the list of web parts.

4. Start entering your markdown code.

   Tip: Click the Edit pencil on the left side of the web part to see a reference of Markdown syntax.

   
   

5. On the toolbar, you can:

   • Use the bold, italic, and strikethrough buttons to quickly format text. For more types of formatting, enter the appropriate markdown syntax.

   • Use the link button to create links to other pages.

   • Select a light or dark theme for the code window.

   • Show or hide a preview.

6. When you're ready, click Publish at the top right of your page.

For more information on markdown utilized by this web part, see the Marked.js documentation.