In this SharePoint Online tutorial, we will discuss on SharePoint Markdown web part.
We will see, what exactly the SharePoint Markdown web part and why we use the Markdown web part in SharePoint online, and how to add the Markdown web part to our SharePoint modern site page and we will see a few examples based on the modern SharePoint online environment.
In SharePoint server 2019, the SharePoint Markdown web part is not available.
SharePoint Modern page Markdown
- Microsoft provides a lot of Out of box web parts, one of the web parts is the Markdown web part.
- Markdown web part is a syntax or set of rules that allows us to add text for a web page.
- Using Markdown language, we can format text for a web page.
- By default, when we add the Markdown web part to our SharePoint page it will display a dark theme and show preview.
- Markdown web part is available only in the Modern SharePoint online.
Read SharePoint Online sites web part
How to add Markdown web part in SharePoint online
Now, let us see how can we add and integrate the Markdown web part to the modern SharePoint.
- Open the SharePoint site page where you want to add the Markdown web part to the SharePoint modern site page.
- Select Edit Page at the top right of the SharePoint site page.
- Click + circled icon then add a new Section layout.
- In the search box, enter Markdown and select the Markdown web part.
- In the below screenshot, you can see the Markdown web part is added, and also it displays the dark theme and shows a preview by default.
- If the preview is enabled, when we start typing our Markup in the left column the output will be displayed in the right column as shown below:
We also have an option to change the dark theme to a light theme. When we choose a light theme, we can see the white background in the left column.
We can also have an option to hide the preview, Select the Hide preview option to hide the preview like below.
This is how we can add the Markdown web part in the modern SharePoint.
Read How to use SharePoint document library web part
Configure the Markdown web part in SharePoint online
Let us see how we can edit and configure the Markdown web part in modern SharePoint.
- Click on the Edit web part properties icon in the Markdown web part, it will open the Markdown web part properties panel as shown below:
SharePoint Markdown examples
- Let us see some examples in the Modern SharePoint Markdown web part.
- In the Markdown web part, we can display the Header, add or Highlight the text in bold or Italic, Paragraphs, Links and Images, Lists, and Tables.
- We will some examples that how can we display it in the Markdown web part as follows:
Read How to change the SharePoint site from private to public
Markdown Headers in SharePoint Online
We can add headings in the Markdown web part using the header element. Enter the header element Markcode in the left column of the mark-down web part. We can add one or more heading elements (h1 to h6). Select Republish to save your changes.
In the below screenshot, In the right column, previews the expected output. This is an example to add headers in the modern SharePoint Markdown web part.
Markdown Emphasis in Modern SharePoint
- We can highlight the text as Bold, italic, and Strikethrough.
- To make the text Bold we can use **Text** or we can select text and click Ctrl+B.
- To make the text Italic we can use _ Text_ or we can select text and click Ctrl+I.
- To make the text Strikethrough we can use ~~Text~~ or we can select text and click Ctrl-L.
- Select Republish to commit your changes.
In the above screenshot, In the right column, previews the expected output. This is an example of the highlighted text in the modern SharePoint Markdown web part.
Read How to share a SharePoint site with external users
SharePoint Modern Markdown Paragraph Blockquote
We can also quote the text using the Blockquote under the paragraph option. Using the greater than symbol (>) we can display it as shown below:
SharePoint online Markdown Code
In the Markdown web part, we can highlight the syntax code. To display the markdown web part code, we have to add four backticks ““ Code ““. In the below example, I have added how to display code using the Markdown web part. Select Republish to save your changes.
Read How to convert SharePoint site to Microsoft Teams
Markdown Links in Modern SharePoint
- We can insert a link in the Markdown web part, when users select the link option it will redirect to the mentioned URL. We can also see the option in the toolbar to insert a link.
- Within the square bracket, we can add the alt text to display [ ]. Within the parenthesis, we have mentioned the link to redirect ( ).
- For example : [SPGuides](https://spguides.com/).
- Select Republish to commit your changes.
SharePoint Modern Markdown image
- We can also display images in the Markdown web part.
- Within the square bracket, we can add the alt text to display [ ]. Within the parenthesis, we have mentioned the image URL with no spaces ( ).
- Syntax begins with an exclamation point.
- For example : .
- Select Republish to commit your changes.
Read SharePoint Online List Web Part
Markdown Lists in SharePoint Online
We can display Bulleted lists and numbered lists in the Markdown web part.In the below example, I have added how to display the Ordered list as well as Numbered list using the Markdown web part. Select Republish to save your changes.
SharePoint Modern Markdown Table
- Tables are also supported in the Markdown web part, we can separate columns with the Pipe character.
- To make it easy, select the example of the Table in the Markdown properties pane. Copy and Paste it into the Mark code.
- Rename the Column Name and Values that you want to display in the Markdown web part, you can also add columns if you want.
In the below example, you can see that we can display a table with values in the modern SharePoint Markdown web part.
These are some examples in the modern SharePoint Markdown web part. And this is how we can edit and configure the SharePoint online Markdown web part.
Sharepoint Online Markdown Table of Contents
Let us see how to display the Table of contents in the modern SharePoint Markdown web part,
yes, it is possible to display the Markdown table of contents in SharePoint.
Follow the below steps to achieve this:
- Initially add the Text web Part to the SharePoint page, Add Heading for the text web part as shown below. Enter the content that you want to display in the text web part.
- Now Publish or Republish the SharePoint page to save your changes.
- Once Published, Hover over the heading and we can see the link option, now copy the link of the text web part like below:
- Now Open the Markdown web part, and Paste the Copied link. Once you Paste the header links, it will redirect to the Particular Heading in the Markdown web part.
- In the same manner, we can add many Topics under the Table of contents in the SharePoint modern Markdown web part.
In the below screenshot, if we select SPGuides it redirects to the SPGuides paragraph. In the same way, if we select EnjoySp it will redirect to the EnjoySP Paragraph.
This is how we can display the Table of contents in the modern SharePoint Markdown web part.
Read SharePoint Online Events Web Part
SharePoint Modern Markdown web part HTML
It is not possible to display HTML code in the SharePoint Online modern markdown web part. If you will add the HTML code, it will render as it is. You can see below:
Follow the below steps to check out this:
- Open the Markdown web part and add the HTML code in the left Column of the Modern SharePoint Markdown.
- Select Republish to commit your changes.
In the below screenshot, we can see the HTML code is displaying in the right side column as it is.
Related SharePoint web part articles:
- SharePoint Group Calendar Web Part
- SharePoint Button and Call to action Web Part
- How to use File viewer web part in SharePoint Online
- SharePoint Image Gallery Web Part
- SharePoint Highlighted content web part
- SharePoint Quick Links Web Part
- SharePoint Online my feed web part
- SharePoint Online sites web part
In this SharePoint tutorial, we have learned the SharePoint Markdown web part, how to add the Markdown web part to the SharePoint modern page, and also covered the below-mentioned topics:
- Configure the Markdown web part in SharePoint online
- SharePoint Markdown examples
- Markdown Headers in SharePoint Online
- Markdown Emphasis in the Modern SharePoint
- SharePoint Modern Markdown Paragraph – Blockquote
- SharePoint online Markdown Code
- Markdown Links in Modern SharePoint
- SharePoint Modern Markdown image
- Markdown Lists in SharePoint Online
- SharePoint Modern Markdown Table
- Sharepoint Online Markdown Table of Contents
- SharePoint Modern Markdown web part HTML
After working for more than 15 years in Microsoft technologies like SharePoint, Office 365, and Power Platform (Power Apps, Power Automate, and Power BI), I thought will share my SharePoint expertise knowledge with the world. Our audiences are from the United States, Canada, the United Kingdom, Australia, New Zealand, etc. For my expertise knowledge and SharePoint tutorials, Microsoft has been awarded a Microsoft SharePoint MVP (9 times). I have also worked in companies like HP, TCS, KPIT, etc.
I believe you can make a table of content just in markdown as well. Table of content:
* [First header](#first-header)
*[Sub header](#sub-header)
# First header
This is a h1-header
## Sub header
This is a h2-header.
Just replace spaces in the links(anchors) with -, ignore special characters. So “#Når – et spørsmål om tid” becomes [link to weird h1](#nr—et-sprsml-om-tid)
Is there a way to make a table fit to the page within sharepoint when creating it through the markdown web part?