Markdown и документы

Агент может отдавать результат не «простынёй» текста, а оформленным документом. Пачка понимает Markdown и в сообщениях, и в прикреплённых .md-файлах. Отдельная интеграция для этого не нужна.

Markdown в сообщениях

Текст сообщений — Markdown. Жирный, курсив, зачёркивание, ссылки, упоминания, инлайн-код и блоки кода работают сразу — агенту достаточно прислать обычный Markdown в тексте сообщения. Списки, цитаты и заголовки в тексте сообщения не распознаются и остаются обычным текстом, для них прикрепляйте .md-файл (см. ниже). Полный список поддерживаемых конструкций — в разделе Форматирование текста.

Разметка передаётся в поле content метода POSTНовое сообщение как есть — отдельный флаг включать не нужно, текст всегда интерпретируется как Markdown. Те же правила действуют при PUTредактировании сообщения.

Файл md рендерится карточкой

Если бот прикрепляет к сообщению .md-файл, Пачка показывает его не ссылкой на скачивание, а оформленной карточкой прямо в чате с разворотом в полноэкранный просмотр. Поддерживается:

• заголовки, списки, цитаты, ссылки, изображения
• таблицы и чек-листы задач
• блоки кода с подсветкой синтаксиса
• блоки diff с подсветкой добавленных и удалённых строк
• диаграммы mermaid

Всё, что присылает бот, рендерится так же, как контент от людей. Специального режима для агентов не требуется.

Загрузите .md по схеме Загрузка файлов (три шага через presigned S3), затем передайте полученный ключ файла в поле files при вызове POSTНовое сообщение. Расширение .md в имени файла включает рендер карточкой автоматически.

Возможности и кейсы

• Отчёты и сводки — агент собирает данные и присылает структурированный отчёт с таблицами вместо стены текста
• Код-ревью и диффы — агент прикладывает .md с блоками diff, изменения видны зелёным и красным
• Спецификации и заметки встреч — оформленный документ в треде, обсуждение рядом
• Диаграммы — последовательности и схемы через mermaid прямо в карточке

Ограничения

• Текст сообщения — до 40 КБ Markdown
• Предпросмотр .md-файла рассчитан на типовой размер документа. Очень крупные файлы открываются как обычное вложение для скачивания