Use a markdown tile on Azure dashboards to show custom content
You can add a markdown tile to your Azure dashboards to display custom, static content. For example, you can show basic instructions, an image, or a set of hyperlinks on a markdown tile.
Add a markdown tile to your dashboard
Select Dashboard from the Azure portal sidebar.
If you've created any custom dashboards, in the dashboard view, use the drop-down to select the dashboard where the custom markdown tile should appear. Select the edit icon to open the Tile Gallery.
In the Tile Gallery, locate the tile called Markdown and select Add. The tile is added to the dashboard and the Edit Markdown pane opens.
Enter values for Title and Subtitle, which display on the tile after you move to another field.
Select one of the options for including markdown content: Inline editing or Insert content using URL.
Select Inline editing if you want to enter markdown directly.
Select Insert content using URL if you want to use existing markdown content that's hosted online.
For added security, you can create a markdown file and store it in an Azure storage account blob where encryption is enabled, then point to the file using the URL option. The markdown content is encrypted through the storage account's encryption options. Only users with permissions to the file can see the markdown content on the dashboard.
Select Done to dismiss the Edit Markdown pane. Your content appears on the Markdown tile, which you can resize by dragging the handle in the lower right-hand corner.
Markdown content capabilities and limitations
You can use any combination of plain text, Markdown syntax, and HTML content on the markdown tile. The Azure portal uses an open-source library called marked to transform your content into HTML that is shown on the tile. The HTML produced by marked is pre-processed by the portal before it's rendered. This step helps make sure that your customization won't affect the security or layout of the portal. During that pre-processing, any part of the HTML that poses a potential threat is removed. The following types of content aren't allowed by the portal:
- iframes -
<iframe>tags will be removed.
- Style -
<style>tags will be removed. Inline style attributes on HTML elements aren't officially supported. You may find that some inline style elements work for you, but if they interfere with the layout of the portal, they could stop working at any time. The Markdown tile is intended for basic, static content that uses the default styles of the portal.
- To create a custom dashboard, see Create and share dashboards in the Azure portal