Skip to main content
The Markdown Widget lets you add formatted text, notes, links, and headings directly to your dashboards. It’s perfect for adding context, documentation, or separating sections visually.

​
When to use

  • Add titles or descriptions to sections of your dashboard
  • Explain metrics or link to external documentation
  • Highlight goals, statuses, or next steps
  • Create visual separators between widgets

​
How to use

Example: 
### User Growth Traces

This section highlights new user signups, retention, and churn over the last 30 days.

- Trace updated hourly  
- Based on `user_events` table in ClickHouse

​
Supported markdown features

  • Headings (#, ##, ###)
  • Bold, italic, and strikethrough text
  • Lists and checkboxes
  • Code blocks and inline code
  • Hyperlinks and external references
  • Emojis 👍 🚀 ✅

​
Best practices

  • Keep notes concise and relevant to nearby widgets
  • Use emoji and headings to make sections scannable
  • Update text as data sources or queries change
⌘I