To use Markdown in a text tile, select Markdown from the dashboard's Add menu when you create the tile. Text tiles are a new type of Looker text tile that do not use Markdown but instead provide a visual editing experience.
You can use text tiles on a dashboard to describe the other tiles and to help viewers understand the information that those tiles present. Looker's Markdown tiles support a limited version of the Markdown markup language in text tiles, which gives you options for formatting your text or adding links and images that can make your dashboards pop.
Markdown syntax supported in Markdown tiles
This page lists the Markdown syntax that is supported for Markdown tiles, with each example shown first in a code block and then as the result.
The styles in which the Markdown elements render on your dashboard tiles may differ from the styles shown here.
Headers are not supported in legacy dashboards.
Dashboards support header levels 1-6:
## Header level 1 ### Header level 2 #### Header level 3 ##### Header level 4 ###### Header level 5 ####### Header level 6
Table columns are sized to the widest data value. You can use
to add width to columns.
| Tables | Are | Cool | | ------------- | ------------- | ----- | | leopards | have spots | $1600 | | zebras | have stripes | $12 | | polar bears | are white | $1 |
Only left justification is supported in table columns.
Emphasis (italics) with *asterisks* or _underscores_. Strong emphasis (bold) with **double asterisks** or __double underscores__. Combined emphasis with **asterisks and _underscores_**.
1. First ordered list item 1. Another item 1. Actual numbers don't matter, just that it's a number 1. And another item
* Unordered lists can use asterisks - or minuses + or pluses
Links can be added in several ways, as shown in the following Markdown:
Which renders like the following:
Images can be referenced by path or URL.
Here's our logo: URL-style: <img src="url/to/image.png"> Inline-style: ![alt text](path/to/image.png) Reference-style: ![alt text][logo]
To control the size of the image displayed in relation to the tile size, use HTML to call the image and add a percent size parameter:
Here is an example changing the size using the
<img src="path/to/image.png" width="50%">
Or, you can provide explicit height and width maximums like this:
<img src="path/to/image.png" width="500px" height="30px">
Height and width pixel parameters will NOT set the image to those exact dimensions; rather, the aspect ratio of the image will be "best fit" to those constraints. For example, if the dimensions "width=100px height=30px" were set on an image that is originally 200px x 20px the result would be 100px x 10px since the logic is roughly "image width exceeds maximum > scale down until width maximum is reached."
Three or more hyphens --- Asterisks *** Underscores ___
> Blockquotes are very handy. > This line is part of the same quote.
> This is a very long line that will be quoted properly when it wraps. I will keep writing to make sure this is long enough to actually wrap for everyone. Also, you can *put* **Markdown** into a blockquote.
Unsupported Markdown syntax
The following Markdown syntax is not supported in dashboard Markdown tiles:
- Images with alt text
- Links with alt text
- Language-specific syntax highlighting
- Headers (not supported in legacy dashboards)
- Strikethrough using two tildes