Форматирование текста

Где доступно форматирование#

Используйте Markdown для выделения текста, ссылок, кода, абзацев, заголовков, списков, цитат и таблиц. Также доступны зачеркивание, списки с флажками и автоматическое распознавание веб-адресов. В описании и названии задачи результат виден после сохранения, в комментариях после отправки. В редакторе многострочного пользовательского поля и страницы базы знаний можно открыть "Просмотр" до сохранения.

В компактных подписях, например в списке выбора задачи, показывается текст без оформления и служебных знаков разметки. Сохраненный исходный текст задачи при этом не меняется. Даты, числа, адреса в специализированных полях и значения списков остаются значениями своих типов.

В форме создания задачи нажмите ? справа от названия Описание: рядом со значком поверх формы появится ссылка Полная справка по форматированию текста на эту статью. Поля остаются на месте. Повторное нажатие, нажатие снаружи или Escape закрывает подсказку. Справка не меняет введенный текст и не отправляет форму.

Выделение#

Окружите текст звездочками или знаками подчеркивания. Для зачеркивания используйте две тильды с каждой стороны.

**жирный** или __жирный__
*курсив* или _курсив_
~~зачеркнутый~~
**жирный и *курсив* вместе**

Результат первых двух вариантов: жирный или жирный; курсив или курсив.

Пробел между открывающим знаком и текстом мешает выделению. Для части слова удобнее звездочки: до**важного**после.

Абзацы и строки#

Для нового абзаца оставьте пустую строку. Обычный перевод строки внутри абзаца также виден при чтении длинного текста. Явный перенос можно задать двумя пробелами в конце строки или обратной косой чертой \ перед переводом строки. В коротких полях переносы между обычными строками отображаются пробелами.

Первая строка
Вторая строка

Следующий абзац

Четыре пробела в начале строки означают блок кода. Для обычного абзаца такой отступ не нужен. Особенности сохранения пробелов описаны в разделе Ограничения и сохранение.

Заголовки#

Начните строку с одного или нескольких знаков #, затем поставьте пробел. Распознаются от одного до шести знаков. При отображении # становится заголовком H2, ## становится H3, далее до H6. Варианты с пятью и шестью знаками показываются на одном уровне H6. Заголовок H1 остается за самой страницей Quevell.

# Главный раздел
## Подраздел
### Детали

Можно использовать подчеркивание заголовка строкой из = или -:

Главный раздел
=============

Подраздел
---------

Заголовки внутри текста не заменяют заголовок страницы Quevell. В коротких полях запись заголовка остается текстом.

Списки#

Для маркированного списка начните строку с -, + или * и пробела. Для нумерованного списка используйте число с точкой. Вложенный пункт сдвиньте вправо относительно родительского; продолжение пункта выровняйте с его текстом.

- Подготовка
  - Проверить описание
  - Собрать материалы
- Выпуск

1. Согласовать
2. Выполнить
3. Проверить

Номер первого пункта задает начало нумерации. Между разными списками удобно оставлять пустую строку.

Списки с флажками#

После маркера списка поставьте [ ] для незавершенного пункта или [x] для завершенного.

- [ ] Проверить текст
- [x] Добавить пример

Вид пунктов:

• ☐ Проверить текст
• ☑ Добавить пример

Флажки в Markdown не переключаются нажатием. Чтобы изменить состояние пункта, откройте редактирование и замените [ ] на [x] или наоборот. Такой список не создает задачи Quevell. Отдельный чеклист задачи остается самостоятельным элементом интерфейса.

Цитаты и разделители#

Начните строку цитаты с >. Внутри цитаты можно использовать абзацы, выделение и списки.

> Решение принято.
>
> Следующий шаг: проверка.

Для разделительной линии используйте отдельную строку с ---, *** или ___. Перед ней оставьте пустую строку: дефисы сразу под текстом могут означать заголовок.

Ссылки#

Текст ссылки пишется в квадратных скобках, адрес в круглых. Подпись, указанная после адреса в кавычках, показывается при наведении.

[Документ](https://example.com)
[Документ](https://example.com "Открыть документ")
https://example.com

Длинный адрес можно вынести отдельно:

Прочитайте [документ][guide].

[guide]: https://example.com "Документ"

Открываются только корректные ссылки http:// и https://. Относительные адреса, ссылки с учетными данными и другие схемы не становятся активными ссылками. Ссылка открывается в новой вкладке. Форматирование не дает доступа к закрытой задаче или файлу.

Код#

Для кода в строке используйте обратные кавычки. Разметка внутри них показывается буквально.

Вызов `load()` и строка `**без выделения**`.

Если в коде есть обратная кавычка, окружите его более длинной последовательностью кавычек:

``код с ` внутри``

Многострочный блок окружите строками из трех обратных кавычек или тильд. Закрывающая последовательность должна быть не короче открывающей. Пример с тильдами:

~~~
if (ready) {
  send();
}
~~~

Другой способ: четыре пробела перед каждой строкой кода. После открывающей последовательности можно указать язык; код все равно остается текстом, без выполнения или построения диаграмм. Упоминания людей и ссылки на вложения внутри кода не активируются.

Таблицы#

Разделите ячейки вертикальными чертами. После строки заголовков должна идти строка-разделитель из дефисов. Пример с обычным выравниванием:

| Название | Количество | Состояние |
| --- | --- | --- |
| **Пример** | 12 | Готово |
| Другой пример | 3 | Проверка |

Результат:

Двоеточие в строке-разделителе задает выравнивание. В этом варианте первый столбец выравнивается слева, второй справа, третий по центру:

| Название | Количество | Состояние |
| :--- | ---: | :---: |
| **Пример** | 12 | Готово |
| Другой пример | 3 | Проверка |

В ячейках работают выделение, ссылки и код внутри строки. Для вертикальной черты внутри ячейки используйте \|. Широкая таблица прокручивается внутри текста, не расширяя всю страницу. Таблицы не вычисляют формулы.

Файлы, картинки и упоминания#

При вставке файла или картинки из буфера обмена в описание задачи или комментарий загрузка начинается сразу. Должен быть выбран проект, в котором у вас есть право добавлять файлы. После успешной загрузки ссылка на файл появляется на месте курсора. До сохранения это личный черновик, доступный только автору.

• Описание задачи: файл становится вложением при создании задачи или сохранении ее изменений, если ссылка на черновик остается в описании.
• Комментарий: файл становится вложением задачи при отправке комментария, если ссылка остается в его тексте. Сохранение описания задачи не отправляет комментарий.
• Отмена: отмена изменений описания или уход без отправки комментария не прикрепляет черновик. Он не удаляется немедленно по факту закрытия формы. Через 24 часа несохраненный черновик недоступен; затем его удаляет плановая очистка. Крестик рядом с черновиком убирает ссылку и отправляет запрос на его удаление сразу. Простое удаление ссылки из текста не вызывает немедленную очистку.
• Ошибка загрузки: появляется сообщение с именем файла и причиной; ссылка на этот файл не добавляется. Уже введенный текст остается. При вставке нескольких файлов остальные продолжают загружаться.

Текст, введенный во время загрузки, сохраняется в редакторе. Если в буфере вместе с файлом есть обычный текст, вставляется текст, а файл не загружается. Это относится, например, к таблице, скопированной вместе с ее изображением.

Существующие вложения разрешаются в контексте текущей задачи. Доступная картинка показывается миниатюрой, другой файл кнопкой скачивания. Если файла нет в доступном списке вложений, вместо него показывается "Файл удален". Эта подпись сама по себе не доказывает физическое удаление файла. Удаление ссылки на уже сохраненное вложение из текста не удаляет само вложение.

Внешняя картинка записывается так:

![Подпись](https://example.com/picture.png)

Quevell показывает внешнюю картинку ссылкой: ее адрес открывается только при нажатии. Чтение текста не загружает изображение с другого сервера. Эта ссылка не превращается во вложение задачи. Внутренние ссылки на вложения создаются Quevell при вставке и сохранении файлов; их отображение описано выше.

В комментарии наберите @, начните вводить имя и выберите пользователя из подсказок. Редактор связывает имя с конкретным пользователем и показывает его как единое упоминание. Просто напечатанное имя, в том числе с @, такой связи не создает. Внутри кода и в экранированных примерах упоминания не активируются и не вызывают уведомлений. Обычное упоминание в отправленном комментарии обрабатывается с учетом доступа пользователя к задаче.

Символы Markdown как обычный текст#

Поставьте обратную косую черту \ перед символом Markdown, который хотите показать как обычный текст. Например, \*текст\* показывает звездочки вокруг слова без курсива. Обратная косая черта экранирует следующий символ; обратная кавычка ограничивает код внутри строки.

\*без курсива\*
\# это не заголовок
\[это не ссылка\]

Внутри блока кода дополнительное экранирование не требуется.

Ограничения и сохранение#

• HTML показывается обычным текстом. Встроенные страницы, скрипты, формулы и диаграммы не запускаются. Сноски Markdown не поддерживаются.
• Форматирование не меняет права доступа к задачам, комментариям, страницам базы знаний и вложениям. Для чтения, редактирования, упоминания пользователя и работы с файлами сохраняются соответствующие проверки доступа.
• Описания задач, многострочные пользовательские поля, комментарии и содержимое страниц базы знаний сохраняют отступы, пробелы в конце строк и конечные переводы строк. Многострочные поля сохраняют исходный текст при создании задачи из общего списка или проекта и при редактировании в карточке задачи. В коротких полях внешние пробелы обрезаются.
• Хранится исходный текст с разметкой. При сохранении вставленных файлов временные ссылки на черновики заменяются ссылками на вложения. Редактор описания и комментария показывает такие ссылки и упоминания компактно, сохраняя их служебную запись в исходном тексте.
• Лимиты поля проверяются для исходной строки вместе со знаками разметки.
• Форматирование не распространяется на все подписи и настройки продукта: применимость перечислена в начале статьи.

В API и MCP передавайте Markdown обычной строкой: например, в description при создании или изменении задачи, в body комментария или страницы базы знаний, в значении пользовательского поля типа core:text или core:paragraph. Преобразование в HTML не требуется. Методы чтения возвращают сохраненный исходный текст; в MCP длинный текст может возвращаться частями. Списки могут содержать только краткие сведения: полный комментарий читается через get_comment, страница через get_page.

Экранирование JSON используется для передачи самой строки: например, \n в JSON обозначает перевод строки, а \\ обозначает одну обратную косую черту. Экранирование Markdown управляет отображением символов внутри уже полученной строки. Передайте строку обычному JSON-сериализатору один раз; не экранируйте дополнительно весь Markdown.

Экспорт сохраняет разметку, без преобразования в HTML. CSV применяет свои правила кавычек и защиты от формул. В архиве с вложениями внутренние ссылки заменяются путями к файлам архива. При скачивании страницы базы знаний в .md к содержимому добавляются заголовок страницы и завершающий перевод строки.

О создании задачи см. Начало работы, об обмене данными: API и MCP.