Markdown

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. Второй пункт

Таблицы

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

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

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

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

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

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

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

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

Если необходимо добавить в ячейку таблицы перенос строки или более сложный элемент (например, список или блок кода), воспользуйтесь альтернативной разметкой:

#||| **Заголовок1** | **Заголовок2** |||| Текст | Текст |||#

Пример разметки с переносами и списком:

#|||Текстна двух строчках|- Пункт 1- Пункт 2- Пункт 3- Пункт 4|||#

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

val a: Int = 1

Каты

Используйте каты, чтобы скрыть часть контента. Например, дополнительную информацию или длинные блоки кода.

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

{% cut "Заголовок ката" %}Контент, который отобразится по нажатию.{% endcut %}

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

Заголовок ката

Контент, который отобразится по нажатию.