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.

Note: 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.

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.

Expand your Office skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×