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

  1. Select Dashboard from the Azure portal sidebar.

    Screenshot showing portal sidebar

  2. 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.

    Screenshot showing dashboard edit view

  3. 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.

  4. Enter values for Title and Subtitle, which display on the tile after you move to another field.

    Screenshot showing results of entering title and subtitle

  5. 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.

      Screenshot showing entering inline content

    • Select Insert content using URL if you want to use existing markdown content that's hosted online.

      Screenshot showing entering URL

      Note

      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.

  6. 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.

    Screenshot showing custom markdown tile

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:

  • JavaScript – <script> tags and inline JavaScript evaluations will be removed.
  • 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.

Next steps