Markdown widget
What it is
Renders formatted text using GitHub Flavored Markdown (GFM) — useful for labels, announcements, status notes, or any free-form content on a dashboard.
Config fields
| Field | What it controls | Example |
|---|---|---|
| Markdown Content | The full GFM markdown source to render. Maximum 50 000 characters. | ## Status\n\nAll systems operational. ✅ |
The editor is a plain monospace textarea. Changes render in real time in the widget preview.
Supported GFM syntax
- Headings (
##,###) - Bold (
**text**), italic (*text*), strikethrough (~~text~~) - Ordered and unordered lists
- Inline code (
`code`) and fenced code blocks (```) - Blockquotes (
> ...) - Tables (pipes syntax)
- Links (
[text](url)) - Horizontal rules (
---)
Raw HTML is not rendered — it will appear as escaped text.
Common pitfalls
- Long lines without line breaks. The tile clips overflow horizontally; use short paragraphs or add explicit newlines to keep content readable at tile width.
- Images via
![](). Markdown image syntax is supported but the image must be a publicly accessible URL. Broken image links show the alt text only. - 50 000 character limit. Very long markdown (e.g. a pasted changelog) will be truncated at the limit. Split into multiple widgets if needed.
Troubleshooting
| Symptom | Try |
|---|---|
| Content not rendering as markdown | Confirm the widget is saved; the preview updates live but unsaved changes revert on page reload. |
| Text overflowing the tile | Add line breaks or shorten paragraphs; resize the tile in the dashboard editor. |
| Link opens inside iframe on display devices | Links open in the same frame by default. On display devices this is expected behaviour. |