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. Find the Toolbox (Toolbox icon in content pane) on the right.

  3. Select See all web parts, then select or drag-an-drop Markdown from the list of web parts.

  4. Start entering your markdown code. Click Edit properties (Icon for editing web part and section properties) on the top left side of the web part to see a reference of Markdown syntax. ​​​​​​​ Markdown web part

  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.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.