Sign in with Microsoft
Sign in or create an account.
Select a different account.
You have multiple accounts
Choose the account you want to sign in with.

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.


  • 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:

    Plus sign for adding web parts to a page

  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 Web part edit button on the 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.

Was this information helpful?

What affected your experience?
By pressing submit, your feedback will be used to improve Microsoft products and services. Your IT admin will be able to collect this data. Privacy Statement.

Thank you for your feedback!