Форматирование текста¶
В комментариях к задачам можно оформлять текст — выделять жирным, добавлять ссылки, создавать списки и многое другое. Для этого используется markdown: специальные символы вокруг текста задают форматирование.
1. Поддерживаемое форматирование¶
Поддерживаемые виды разметки и их доступность на платформах:
| Синтаксис | Результат | Веб: лента | Веб: чат | iOS | Android |
|---|---|---|---|---|---|
**текст** |
Жирный | + | + | + | + |
__текст__ |
Курсив | + | + | + | + |
~~текст~~ |
Зачёркнутый | + | + | + | + |
((текст)) |
Подчёркнутый | + | + | + | + |
`текст` |
Код (моноширинный шрифт) | + | + | + | — |
[текст](url) |
Именованная ссылка | + | + | + | + |
# текст … ###### текст (до шести #) |
Заголовок — выделяется полужирным как акцент, размер шрифта не меняется | + | + | — | — |
```...``` |
Блок кода (с фоном, моноширинный) | + | + | ± | ± |
\| a \| b \|\| --- \| --- \|\| 1 \| 2 \| |
Таблица с заголовком и рамкой. В ленте растягивается по ширине, в чате — с прокруткой. | + | + | — | — |
#12345 |
Ссылка на задачу по номеру | + | + | + | + |
@ + имя пользователя |
Упоминание пользователя (@-тег) | + | + | + | + |
URL (https://...) |
Автоматическая кликабельная ссылка | + | + | + | + |
| Ссылка на Диск | Открывает папку/файл Диска в превью | + | + | — | — |
- текст |
Маркированный список | + | + | — | — |
1. текст |
Нумерованный список. Пункты сохраняют исходные номера — например, 3. 4. 5. так и отображаются как 3. 4. 5., в том числе после отправки комментария. |
+ | + | — | — |
--- (на отдельной строке) |
Горизонтальный разделитель | + | + | — | — |
+++ (на отдельной строке, с 2.268.352) |
Спойлер — всё, что ниже первого +++ в комментарии, сворачивается в раскрываемый блок «Показать больше». Повторные +++ ниже первого отображаются как обычный текст (без вложенности). Старая обёртка [+][-] (прежний формат системных комментариев) больше не обрабатывается — если придёт из старой версии, отображается как обычный текст без ошибок. |
+ | + | — | — |
| Нажатие Enter | Перенос строки | + | + | + | + |
Обозначения: + — работает; — — не отображается, виден исходный текст вместе с символами разметки; ± — работает частично (на iOS и Android содержимое тройных обратных кавычек показывается моноширинным шрифтом, но без плашки-фона).
⚠️ Важно:
__текст__в 1Форме — это курсив, не жирный. Для жирного всегда используй**текст**.
Подсветка синтаксиса в блоках кода. Если сразу после открывающих тройных обратных кавычек указать язык (например, sql), блок кода в ленте и чате подсвечивается по синтаксису — для поддерживаемых языков. Без указания языка или для неподдерживаемого языка блок отображается как обычный моноширинный текст, без подсветки.
Быстрая подстановка # к номеру задачи. Скопируйте номер задачи из шапки её карточки или из мобильной табличной формы (МТФ) и в течение 120 секунд вставьте в поле сообщения (комментарий, чат, соцсеть) — номер автоматически станет ссылкой на задачу вида #12345. Подстановка срабатывает только для номера из одних цифр и только при вставке в поле сообщения: в поиске, админке, текстовых ДП, а также при вставке текста с другими символами номер остаётся без изменений. Буфер обмена не меняется — # добавляется лишь в момент вставки.
2. Ограничения и поддержка на платформах¶
В комментариях 1Формы не поддерживаются HTML-теги, встроенные изображения, цитаты, вложенные списки и курсив через одинарную звёздочку; на веб и мобильных клиентах набор отображаемых элементов различается.
- HTML-теги (
<br>,<b>,<p>,<div>и любые другие) — отображаются как обычный текст или игнорируются. Если нужно вставить угловую скобку<, она отобразится корректно — система автоматически её экранирует. Разметка из текста очищается перед показом; пример тега или атрибута в сообщении чата больше не ломает отображение остального текста — очищается только сам фрагмент, а переносы строк, ссылки и выделение сохраняются, как в ленте. - Изображения в тексте (
) — вставить картинку в текст комментария нельзя, только как вложение. - Курсив через одинарную звёздочку (
*текст*) — не работает. Используй__текст__. - Цитаты (
> текст) — не поддерживаются ни на одном клиенте, символ>останется в тексте. - Вложенные списки — только один уровень. Пункт с отступом перед
-не становится подпунктом: он выпадает из списка и разрывает его на два. - Текст в квадратных скобках «склеивается» со ссылкой, стоящей дальше в том же абзаце. Разбор ссылок жадный: открывающая
[ищет закрытие не рядом, а по первому](в абзаце — и всё между ними становится телом одной ссылки. Наблюдено на комментарии вида[intake:2126589] Разбор. Причина падения: … реализовано в [2074052](https://ru.1forma.ru/spa/tasks/2074052): вся строка отрендерилась одной синей ссылкой, ведущая[пропала. Обходится переносом: текст в скобках — отдельным абзацем (пустая строка между ним и абзацем со ссылкой). Одиночные скобки без ссылки в том же абзаце отображаются нормально, поэтому дефект перемежающийся и на коротких сообщениях не виден.
В веб-интерфейсе (лента и чат) поддерживаются все форматы из таблицы выше: жирный, курсив, зачёркнутый, подчёркнутый, код, ссылки, заголовки, блоки кода, таблицы, маркированные и нумерованные списки, разделители, спойлер, упоминания и ссылки на задачи. Оформление одинаковое: лента и чат используют один и тот же обработчик разметки, различается только ширина области — широкая таблица в ленте растягивается, в бабле чата прокручивается по горизонтали.
В мобильном приложении (iOS и Android) поддерживаются: жирный, курсив, зачёркнутый, подчёркнутый, моноширинный текст, именованные ссылки, ссылки на задачи (#12345), @-упоминания, обычные URL и переносы строк. Для моноширинного текста на iOS годятся и одиночные обратные кавычки, и тройные; на Android — только тройные (одиночные останутся в тексте как символы).
Не отображаются на мобильных: заголовки, таблицы, маркированные и нумерованные списки, горизонтальный разделитель, спойлер, превью Диска — эти элементы будут показаны как обычный текст с символами разметки. Если сообщение важно читать с телефона, лучше использовать только жирный, курсив и моноширинный текст, а списки набирать тире с новой строки.