Как добавить текст на дашборд DataLens

Чтобы добавить текст на дашборд DataLens, перетащите виджет «Текст» в нужную область и введите пояснение: как считается метрика, откуда данные и где прочитать методику.

Перетащить виджет «Текст» и настроить его

Порядок действий из справки по добавлению текста^[1]:

На панели слева нажмите Дашборды и выберите нужный дашборд. Если дашборда ещё нет, создайте его.
В верхней части страницы нажмите кнопку Редактировать.
На панели в нижней части страницы зажмите Текст и перетащите его в нужную область.
Введите текст ссылки, поясняющей надписи и т.д. Виджет поддерживает язык разметки Markdown.
Опционально задайте фон и прозрачность виджета отдельно для светлой и тёмной темы.
Опционально задайте скругление виджета.
Нажмите кнопку Добавить. Виджет отобразится на дашборде.

Фон и прозрачность можно задать отдельно для светлой и тёмной темы. Скругление задаёт форму углов и визуально отделяет блок пояснений от чартов. Оба параметра необязательны: виджет читается и без них, но на дашборде с плотной сеткой графиков аккуратный фон помогает отделить пояснение от визуализации.

Что поддерживает виджет: Markdown и только текст

По справке о виджетах^[2], в виджете «Текст» можно использовать текстовое содержимое и разметку Markdown.

Поддерживаемые элементы по справке по Markdown в DataLens^[3]:

Заголовки — четыре уровня.
Выделение текста — полужирный, курсив, подчёркивание, зачеркивание, верхний и нижний регистр, моноширинный, выделение цветом пометки.
Цвет текста — {цвет}(текст), доступны gray, yellow, orange, red, green, blue, violet.
Списки — простые и вложенные, неупорядоченные и упорядоченные.
Таблицы — с выравниванием по левому краю, правому краю и центру; перенос строки внутри ячейки требует альтернативной разметки #|.
Каты — скрытые блоки, раскрывающиеся по нажатию, через {% cut %}.
Табы — взаимоисключающие разделы через {% list tabs %}.
Ссылки.
Оформление кода — инлайн и блоком.
Изображения.
Эмодзи.
Диаграммы Mermaid.

Таблицу нужно отделять от соседнего текста пустыми строками, иначе разметка не разберётся. Для вложенных списков отступ считается в пробелах: от двух до пяти для неупорядоченного, от трёх до шести для упорядоченного. Разница в отступах заметна, когда блок собирается в редакторе вручную.

Учебный пример

Задача: пояснить читателю отчёта, как считается CPL, откуда данные и как часто они обновляются. Содержимое виджета собрано из таких входов:

Поле	Значение
Заголовок блока	Как читать отчёт
Формула CPL	расходы / заявки
Источник данных	Учебный CSV
Обновление	вручную по пятницам
Ссылка на методику	`https://example.com/method`

Текст для вставки в виджет:

# Как читать отчёт

**CPL** = расходы / заявки.

- Источник: Учебный CSV
- Обновление: вручную по пятницам
- [Методика расчёта](https://example.com/method)

Что получится в просмотре: заголовок первого уровня, полужирное обозначение метрики, формула в той же строке, маркированный список с источником, периодичностью обновления и кликабельной ссылкой на методику. Пояснение занимает один виджет и читается за несколько секунд.

Это учебный пример с синтетическими данными. Формулу CPL, частоту обновления и ссылку подставьте свои — проверьте только, что редактор принимает разметку и что ссылка ведёт туда, куда вы рассчитывали.

Соседние темы: когортный анализ и причины падения GSC.

Текст или Заголовок: что выбрать

Оба виджета принимают только текстовое содержимое. Различие в назначении.

«Текст» — блок пояснений: набор ссылок, определение метрики, описание источника данных. Из справки по виджетам^[2] он позволяет разместить поясняющие надписи на дашборде и поддерживает Markdown.

«Заголовок» — отделяет чарты по смыслу и разбивает их на группы в рамках одной страницы, а также формирует оглавление дашборда. Markdown в нём не нужен: это короткая подпись раздела.

Правило выбора простое: если содержимое отвечает на вопрос «что это показывает», берите «Текст». Если отвечает на вопрос «какой это раздел», берите «Заголовок». Оглавление дашборда собирается из виджетов «Заголовок», поэтому порядок разделов лучше продумать до добавления.

Проверка в режиме просмотра

После сохранения дашборда выйдите из режима редактирования и пройдите по чек-листу:

Переносы строк — абзацы, списки и таблица разбиты там, где задумано; в таблице нет склеенных строк.
Форматирование — заголовки, полужирный и списки отображаются, а не показываются символами разметки.
Переход по ссылке — ссылка «Методика расчёта» в учебном виджете ведёт на https://example.com/method; в своём блоке проверьте адрес вашей методики.
Светлая и тёмная тема — фон и прозрачность читаются в обеих темах; текст не сливается с фоном.
Скругление — форма виджета совпадает с соседними блоками.
Оглавление — если использовался виджет «Заголовок», раздел появился в оглавлении с нужным названием.

Если таблица отображается символами разметки, проверьте пустые строки до и после неё: это требование справки по Markdown^[3]. Остальные элементы сверьте с примерами синтаксиса в той же справке.

Учебный пример