> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openlit.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Markdown Widget

> Learn how to use the Markdown Widget in OpenLIT to add rich text, annotations, and links to your dashboards.

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

<iframe className="w-full aspect-video" src="https://www.youtube.com/embed/vBUk6_Z9XLE?list=PLgErWFh-dyiGp9yUDnnx67wHEeNqzzMXZ" title="How to Use the Markdown Widget in OpenLIT – Visualize Trends Over Time" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

Example:

```markdown theme={null}
### 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