Коротко
Telegram відтворює дев'ять стилів тексту і нічого більше – заголовків і таблиць немає. Більшість зламаних дописів походить від одного з двох: markdown, написаний для рушія, якого в Telegram немає, або повідомлення, обрізане за довжиною вже після конвертації, що розриває тег навпіл.
Головне
- Ні заголовків, ні таблиць, ні вкладених списків. Заголовок markdown показується як буквальний символ ґратки.
- Ліміт 4096 рахується в кодових одиницях UTF-16, а не в символах. Емодзі поза базовою площиною коштує дві.
- Підписи до медіа обмежені значно жорсткіше за повідомлення – приблизно 1024, – тож допис, який вміщається як текст, може не вміститися під фото.
- Форматування переживає копіювання та вставку всередині Telegram, бо передається як діапазони сутностей, а не як розмітка.
- Ріжте до конвертації, ніколи після. Обрізання готової розмітки – саме те, що залишає напіввідкритий тег і відхилене повідомлення.
Що Telegram насправді відтворює
| Стиль | Відтворюється | Примітки |
|---|---|---|
| Жирний | Так | Єдиний стиль, вартий використання майже в кожному дописі. |
| Курсив | Так | Назви, цитовані фрази. |
| Підкреслення | Так | На практиці рідкісне; читається як посилання, яким не є. |
| Закреслення | Так | Виправлення та «було/стало». |
| Спойлер | Так | Прихований, доки не торкнутися. |
Моноширинний | Так | Пригнічує будь-яке форматування всередині себе. |
| Блок коду | Так | Багаторядковий, із необов'язковою міткою мови. |
| Цитата | Так | На рівні рядка, можна зробити розгортаною. |
| Посилання | Так | Текстові посилання, а не лише голі URL. |
| Заголовки | Ні | Ґратка на початку рядка показується буквально. |
| Таблиці | Ні | Перетворюються на стіну вертикальних рисок. |
| Вкладені списки | Ні | Відступи не інтерпретуються. |
| Зображення в тексті | Ні | Медіа прикріплюється до повідомлення, а не вбудовується в нього. |
Саме відсутність заголовків підводить найчастіше, бо майже кожен інструмент для чернеток їх створює. Якщо вашій чернетці потрібні заголовки, щоб нею можна було орієнтуватися, вона структурована як стаття і потребує переписування як допис.
Два способи передати форматування
Допис може нести форматування в одній із двох форм, і варто знати, якою саме ви користуєтеся.
Як розмітку, коли текст містить маркери, які інтерпретує парсер. Telegram приймає підмножину HTML і діалект markdown під назвою MarkdownV2. Підмножина HTML поблажливіша: вона використовує звичайні теги, а випадкова кутова дужка в прозі трапляється значно рідше, ніж випадкова зірочка чи крапка.
Як сутності, коли текст простий, а форматування йде поруч списком діапазонів: жирний зі зсуву 12, довжина 6. Саме це Telegram використовує всередині, і саме тому форматування виживає, коли ви копіюєте допис усередині застосунку – ви копіюєте діапазони, а не розмітку, яку треба заново розбирати.
Вимога екранування в MarkdownV2 – звичне джерело халепи. Кожен із цих символів має бути з зворотним слешем усюди, де трапляється буквально:
_ * [ ] ( ) ~ ` > # + - = | { } . !Сюди входить і крапка, яка є практично в кожному реченні. Надсилання неекранованої прози як MarkdownV2 – найпоширеніший спосіб узагалі не надіслати допис.
Як насправді рахується ліміт 4096
Ліміт текстового повідомлення – 4096, а підпису до медіа значно менший, близько 1024. Але одиниця виміру не та, яку більшість припускає.
Telegram рахує кодові одиниці UTF-16. Для звичайного латинського тексту це те саме, що рахувати символи. Для всього поза базовою багатомовною площиною – більшості емодзі, а також усіх послідовностей із тоном шкіри чи прапорами – один видимий гліф коштує дві одиниці, а складене емодзі може коштувати значно більше.
Практичні наслідки:
- Допис із великою кількістю емодзі ближчий до стелі, ніж підказує кількість символів.
- Перевірка довжини, написана наївним підрахунком символів, розійдеться з підрахунком Telegram – і розійдеться саме на тих дописах, які й так були біля межі.
- Екранування та конвертація обидва розширюють текст. Допис із великою кількістю лапок суттєво росте після конвертації в підмножину HTML, бо кожна лапка стає багатосимвольною сутністю. Текст, що вміщався як джерело, може не вміститися як розмітка.
П'ять речей, які ламають допис
1. Різати після конвертації. Якщо обрізати повідомлення, яке вже містить розмітку, зріз може потрапити всередину тега – а напіввідкритий тег означає відхилене повідомлення, а не просто дивний вигляд. Спершу ріжте вихідний текст, потім конвертуйте. У такому порядку незакритий маркер просто показується буквальним символом: неохайно, але нешкідливо.
2. Припускати, що заголовки є. Рядок, що починається з ґратки, показується ґраткою. Другий теж, і вже на четвертому у вашому дописі замість структури – видима пунктуація. Використовуйте натомість жирний в окремому рядку.
3. Вставляти таблицю. Таблиці не відтворюються, а вставлена рисками таблиця нечитома в колонці завширшки з телефон. Перепишіть рядки короткими реченнями або скоротіть порівняння до двох рядків, які справді мали значення.
4. Неекранована пунктуація в MarkdownV2. Див. перелік символів вище. Однієї неекранованої крапки достатньо, щоб повідомлення відхилили.
5. Форматування всередині коду. Моноширинний текст і блоки коду пригнічують усе всередині себе – жирний усередині коду лишиться буквальними зірочками. Це правильна поведінка, яка дивує при першій зустрічі.
Попередній перегляд посилань – це рішення про макет
Будь-яке посилання в дописі може створити картку попереднього перегляду, і ця картка часто є найбільшим і найпомітнішим елементом повідомлення. Це справжній вибір макета, а не дрібниця:
- Дайте їй показатися, коли суть – у джерелі й картка продає за вас.
- Приберіть її, коли роботу робить ваш власний перший рядок, а картка потягне око повз нього.
- Поставте посилання в кінець, якщо хочете обидва: читач отримає спершу вашу рамку, потім картку.
Допис із трьома посиланнями показує попередній перегляд для першого і нічого для решти – це варто знати, якщо ви припускали, що показане буде саме важливе.
Перевірте перед публікацією
Надішліть допис собі або в приватний канал з одним учасником і прочитайте його на телефоні. Це ловить секунд за десять усе, що ховає десктопний редактор: де лягає згортання «показати більше», чи не затьмарює картка початок, чи вцілів задуманий розрив рядка і чи взагалі відтворюється обране емодзі на вашій платформі.
Якщо ви публікуєте щотижня, саме цей крок варто зробити автоматичним, а не пропустити.
Як це робить Ingy
Ingy пише дописи в підмножині markdown, дібраній під те, що Telegram справді відтворює, а при надсиланні конвертує у форму HTML – тож чернетка, яку ви читаєте в боті, і є допис, який отримає ваш канал. Довжина вимірюється у власних одиницях Telegram, а будь-яке обрізання відбувається з вихідним текстом до конвертації, ніколи з готовою розміткою. Ви копіюєте в канал одне повідомлення з неушкодженим форматуванням.
Редакторську половину роботи – рішення, про що взагалі допис – описано в тексті як перетворити статтю на допис у Telegram.
Поширені запитання
Чи підтримує Telegram заголовки markdown?
Ні. Рядок, що починається з ґратки, показується буквальною ґраткою. У Telegram немає стилю заголовка взагалі – використовуйте жирний в окремому рядку там, де інакше поставили б заголовок.
Який ліміт символів для допису в Telegram?
4096 для текстового повідомлення і приблизно 1024 для підпису до медіа. Обидва рахуються в кодових одиницях UTF-16, а не в символах, тож емодзі поза базовою багатомовною площиною рахується як дві одиниці й більше.
Чому моє відформатоване повідомлення не надсилається?
Майже завжди через неекранований символ у MarkdownV2 або тег, розірваний обрізанням. MarkdownV2 вимагає зворотний слеш перед кожним із довгого переліку символів, зокрема перед крапкою, а обрізання повідомлення за довжиною після конвертації може лишити тег напіввідкритим.
Чи можна використовувати таблиці в дописі Telegram?
Ні. Таблиці з вертикальними рисками показуються буквальними рисками й нечитомі на телефоні. Перепишіть два рядки, які несуть суть, короткими реченнями прози.
Чи переживає форматування копіювання та вставку?
Усередині Telegram – так: форматування передається діапазонами сутностей, прикріпленими до тексту, а не розміткою, тож скопійований допис зберігає жирний і посилання. Вставка у зовнішній редактор зазвичай це втрачає.
Чи можна сховати частину допису за спойлером?
Так. У Telegram є стиль спойлера, який лишається прихованим, доки читач не торкнеться його; він доступний і в підмножині HTML, і в MarkdownV2.