Форматирование текста
Текст в Пачке форматируется через markdown. Один и тот же набор конструкций работает везде, где вы передаёте текст как markdown.
Где применяется
- Сообщения — поле
contentметода POSTНовое сообщение и PUTРедактирование сообщения интерпретируется как markdown. Альтернатива — структурная параtext+markup, тогда markdown не разбирается. - Входящие вебхуки — текст, который шаблонизатор подставляет в сообщение, см. Входящие вебхуки.
- Блоки форм — поле
textблокаmarkdown, см. Блоки представления.
Движок единый, поэтому набор конструкций одинаков для всех трёх случаев.
Строчные конструкции
| Элемент | Синтаксис | Результат |
|---|---|---|
| Жирный | **это жирный текст** или __это жирный текст__ | это жирный текст |
| Курсив | *это курсивный текст* или _это курсивный текст_ | это курсивный текст |
| Зачеркнутый | ~~это зачеркнутый текст~~ | |
| Ссылка | [текст ссылки](https://www.google.com) | текст ссылки |
| Строчный код | `код в тексте` | код в тексте |
Блок кода — конструкция из нескольких строк, она разобрана отдельно ниже.
Блоки кода
Открывающий и закрывающий заборы из трёх обратных кавычек должны стоять на отдельных строках. Если написать заборы и текст в одну строку, блок кода не сформируется.
Однострочный вариант вида ```строка кода``` блоком кода не становится. Текст после открывающего забора Пачка считает названием языка, а закрывающий забор на той же строке остаётся обычным текстом.
Язык подсветки
Язык для подсветки синтаксиса указывается сразу после открывающего забора, без пробела. Содержимое начинается со следующей строки.
Если язык не указать, Пачка определяет его автоматически по содержимому. На кириллическом тексте автоопределение почти всегда даёт 1C, поэтому для обычного текста без кода указывайте язык text — это убирает ошибочную пометку.
Выбрать язык в интерфейсе формы нельзя, он берётся только из текста.
Что не поддерживается
Эти конструкции в тексте сообщений, вебхуках и блоках форм не распознаются и остаются обычным текстом (символы -, 1., >, # отображаются как есть):
- маркированные и нумерованные списки
- цитаты
- заголовки
- таблицы
Если нужен богатый markdown с таблицами, чек-листами, блоками diff и диаграммами mermaid, прикрепите его .md-файлом — Пачка отрендерит файл оформленной карточкой. Подробнее — в разделе Markdown и документы.