Оформление текста
Сообщения бота можно оформлять так же, как статьи: заголовки, жирный текст, списки, таблицы, сворачиваемые блоки и картинки. Для этого используется разметка Markdown — несколько простых значков вокруг текста.
Не хотите запоминать значки?
Выделите текст в редакторе и нажмите нужную кнопку на панели инструментов — разметка вставится сама. Эта страница поможет понять, что означают значки в готовых шаблонах.
Строки и абзацы
Разметка в режиме Rich совместима с Markdown, как на GitHub, поэтому работает правило: абзацы разделяются пустой строкой.
Привет, {{ member.name }}!
Мы рады видеть тебя в нашем чате.Если две строки идут подряд без пустой строки между ними, Markdown может склеить их в один абзац. Чтобы строки шли одна под другой, оставляйте между ними пустую строку или оформите их списком.
Выделение текста
| Как выглядит | Как написать | Кнопка |
|---|---|---|
| Жирный | **текст** | Ctrl + B |
| Курсив | *текст* | Ctrl + I |
| Подчеркнутый | <u>текст</u> | Ctrl + U |
~~текст~~ | Ctrl + Shift + X | |
| Спойлер | ||текст|| | «Спойлер» |
| Маркер | ==текст== | «Маркер» |
Моноширинный | `текст` | «Код» |
| x2 | x<sup>2</sup> | «Индексы» |
| H2O | H<sub>2</sub>O | «Индексы» |
Спойлер скрыт, пока участник на него не нажмет. Наведите курсор на серую плашку в таблице, чтобы посмотреть, как это работает.
Два подчеркивания — это жирный
__текст__ в Telegram делает текст жирным, а не подчеркнутым. Для подчеркивания пишите <u>текст</u>.
Разметку можно ставить вокруг переменных:
Поздравляем, **{{ member.name }}**! Теперь у тебя ~~{{ member.rank.level - 1 }}~~ **{{ member.rank.level }}** уровень.Поздравляем, Анна! Теперь у тебя 11 12 уровень.
Заголовки
Решетка # в начале строки делает заголовок. Чем больше решеток, тем меньше заголовок — всего шесть размеров.
# Большой заголовок
## Заголовок поменьше
### Еще меньшеБольшой заголовок
Заголовок поменьше
Еще меньше
После решетки обязательно ставьте пробел: # Правила, а не #Правила.
Списки
Маркированный список — строки, которые начинаются с дефиса и пробела. Нумерованный — с цифры и точки. Чек-лист — с - [ ] (пустой квадрат) или - [x] (с галочкой).
**Что можно:**
- общаться
- делиться скриншотами
**Как вступить в клуб:**
1. Набрать 20 000 кубков
2. Написать президенту
**Задания на неделю:**
- [x] Поздороваться
- [ ] Сыграть 10 матчейЧто можно:
- общаться
- делиться скриншотами
Как вступить в клуб:
- Набрать 20 000 кубков
- Написать президенту
Задания на неделю:
- ☑ Поздороваться
- ☐ Сыграть 10 матчей
Цитаты
Строка, которая начинается с >, становится цитатой:
> Лучший способ выиграть — играть вместе.Лучший способ выиграть — играть вместе.
Для цитаты, которая раскрывается по нажатию, и цитаты с автором удобнее функция quote:
{{ quote('Лучший способ выиграть — играть вместе.', 'Президент клуба') }}Таблицы
Таблица рисуется вертикальными чертами. Первая строка — заголовки столбцов, вторая — дефисы, дальше — данные:
| Уровень | Награда |
|---|---|
| 5 | Роль «Активный» |
| 20 | Доступ к медиа |
| 50 | Роль «Легенда» || Уровень | Награда |
|---|---|
| 5 | Роль «Активный» |
| 20 | Доступ к медиа |
| 50 | Роль «Легенда» |
Данные в таблице — через функцию
Если в ячейку таблицы нужно подставить переменную, используйте функцию table, а не {{ }} внутри строки с чертами. Если имя участника будет содержать |, самодельная таблица развалится, а функция table это учитывает. Редактор предупредит, если вы поставите {{ }} в строку таблицы.
Сворачиваемый блок
Длинный текст можно спрятать под заголовок — участник раскроет его, если захочет:
<details><summary>Правила чата</summary>
1. Без рекламы
2. Без оскорблений
3. Без спама
</details>Правила чата
- Без рекламы
- Без оскорблений
- Без спама
Пустые строки после <summary> и перед </details> обязательны — без них список внутри не распознается.
Разделитель и подвал
Три дефиса --- на отдельной строке рисуют горизонтальную линию. Мелкая строка внизу сообщения — функция footer:
Правила обновлены.
---
{{ footer('Обновлено 1 сентября') }}Ссылки и упоминания
| Что нужно | Как написать |
|---|---|
| Ссылка с текстом | [Правила](https://telegra.ph/pravila) |
| Упоминание участника | {{ member }} или {{ mention(member, 'текст') }} |
| Ссылка из переменной | {{ link('Профиль', member.avatarUrl) }} |
| Почта или телефон | [Написать](mailto:mail@example.com), [Позвонить](tel:+70000000000) |
Переменная внутри ссылки
Не пишите [текст]({{ адрес }}): если в адресе окажется скобка, ссылка сломается. Используйте функцию link('текст', адрес) — она все сделает правильно.
Картинки и видео
Картинка вставляется так же, как ссылка, но с восклицательным знаком впереди. В квадратных скобках — подпись:
Ссылка должна начинаться с https://. Видео, GIF, аудио и документы вставляются так же — Telegram сам определит тип по ссылке. Для подписи, спойлера на картинке, коллажа из нескольких фото или слайдшоу есть функции — смотрите Rich-сообщения.
Эмодзи
Обычные эмодзи просто вставляйте в текст: 🎉 👋 🏆. Кастомные эмодзи из наборов Telegram бот может отправлять, только если у владельца бота есть Telegram Premium.
Если выбран режим Text
В режиме Text работают жирный, курсив, подчеркнутый, зачеркнутый, спойлер, код, ссылки и цитаты. Все остальное бот упростит сам:
| В режиме Rich | В режиме Text станет |
|---|---|
| Заголовок | Жирная строка |
| Список | Строки с «•» или «1.» |
| Чек-лист | Строки с ☐ и ☑ |
| Таблица | Моноширинный текст с выровненными столбцами |
| Сворачиваемый блок | Раскрывающаяся цитата с жирным заголовком |
| Разделитель | Строка «———» |
| Маркер | Жирный |
| Несколько картинок | Первая — картинкой, остальные — ссылками |
Редактор предупредит, если в шаблоне есть то, что в режиме Text будет выглядеть иначе.
То же самое на HTML
Если вам привычнее HTML, переключите синтаксис шаблона на HTML и пишите теги:
<h2>Добро пожаловать, {{ member.name }}!</h2>
<p>Ты <b>{{ chat.memberCount }}</b>-й участник.</p>
<tg-spoiler>Секрет: в чате есть пасхалка</tg-spoiler>Полный список тегов — в статье Rich-сообщения и разметка.