Подключиться
Yandex DataLens

Использование Markdown в DataLens

DataLens позволяет использовать язык разметки Markdown в виджете Текст на дашборде.
Вы можете разместить поясняющий текст, ссылки, таблицу или выделить значимые моменты с помощью форматирования.

В текстовых виджетах вы можете использовать следующие элементы:

Заголовки

Вы можете использовать четыре уровня заголовков в виджете.
Для обозначения заголовка используется символ #.

Пример синтаксиса:

# Заголовок 1 уровня
## Заголовок 2 уровня
### Заголовок 3 уровня
#### Заголовок 4 уровня

Выделение текста

Вы можете выделить важное в тексте с помощью форматирования:

  • Чтобы выделить текст полужирным шрифтом, используйте удвоенный символ *:

    Этот текст выделен **полужирным шрифтом**.

  • Чтобы выделить текст курсивом, используйте символ _:

    Этот текст выделен _курсивом_.

  • Чтобы выделить текст полужирным шрифтом и курсивом, используйте одновременно удвоенный символ * и символ _:

    Этот текст выделен _**полужирным шрифтом и курсивом**_.
Этот текст выделен **_полужирным шрифтом и курсивом_**.

Списки

Вы можете использовать несколько вариантов списков для структурирования информации на дашборде.

Простой неупорядоченный список

Чтобы оформить неупорядоченный маркированный список, используйте символы *, - или +.

Например, следующая разметка:

* Элемент 1
* Элемент 2
* Элемент 3

будет отображаться так:

  • Элемент 1
  • Элемент 2
  • Элемент 3

Вложенный неупорядоченный список

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

Например, следующая разметка:

- Элемент 1
   - Элемент A
   - Элемент B
- Элемент 2

будет отображаться так:

  • Элемент 1
    • Элемент A
    • Элемент B
  • Элемент 2

Простой упорядоченный список

Чтобы оформить упорядоченный список, используйте цифры с символом . или ).

Например, следующая разметка:

1. Первый пункт
1. Второй пункт
1. Третий пункт

будет отображаться так:

  1. Первый пункт
  2. Второй пункт
  3. Третий пункт

Вложенный упорядоченный список

Чтобы оформить вложенный упорядоченный список, добавьте отступ в начале строк с элементами вложенного списка. Допустимый размер отступа — от трех до шести пробелов.

Например, следующая разметка:

1. Первый пункт
   1. Вложенный пункт
   1. Вложенный пункт
1. Второй пункт

будет отображаться так:

  1. Первый пункт

    1.1. Вложенный пункт

    1.2. Вложенный пункт

  2. Второй пункт

Таблицы

Таблица состоит из одной строки с заголовками, разделительной строки и строк с данными.

Каждая строка таблицы состоит из ячеек, отделенных друг от друга символами |.

В ячейках разделительной строки используются только символ - и символ :. Символ : ставится в начале, в конце или с обеих сторон содержимого ячейки разделительной строки, чтобы обозначить выравнивания текста в соответствующем столбце по левой стороне, по правкой стороне или по центру соответственно.

Таблицу нужно отделять от предшествующего и последующего текста пустыми строками.

Например, следующая разметка:

По левому краю | По правому краю | По центру
:--- | ---: | :---:
Текст | Текст | Текст

будет отображаться так:

По левому краю По правому краю По центру
Текст Текст Текст

С помощью ссылок вы можете указать информацию, которые имеет отношение к дашборду или чартам.
Например, добавить ссылки на другие дашборды, указать источники данных.

Ссылка состоит из двух частей:

  • [текст] — текст ссылки.
  • (ссылка) — URL или путь до файла, на который делается ссылка.

Например, следующая разметка:

[ссылка на yandex.ru](https://yandex.ru).

будет отображаться так:

ссылка на yandex.ru.

Оформление кода

Фрагмент кода можно оформить как часть предложения или как отдельный блок.

Фрагмент кода как часть предложения

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

Например, следующая разметка:

Предложение с `фрагментом кода`.

будет отображаться так:

Предложение с фрагментом кода.

Фрагмент кода отдельным блоком

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

Например, следующая разметка:

    ```kotlin
    val a: Int = 1
    ```

будет отобраться как фрагмент кода на языке Kotlin с подсветкой:

val a: Int = 1