К основному содержимому

Markdown в карточках и комментариях на доске

Доска RetroPoint с форматированной карточкой, комментарием и включённой функцией Markdown

На досках RetroPoint появилась опциональная поддержка базового синтаксиса Markdown. Теперь длинную карточку можно разбить заголовками и списками, выделить ключевую мысль, оформить цитату или добавить HTTPS-ссылку. Та же настройка действует в комментариях, поэтому обсуждение сохраняет структуру рядом с исходной карточкой.

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

Что можно оформить

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

  • заголовки шести уровней от # до ######, если после решёток стоит пробел
  • жирный текст через **две звёздочки** или __два подчёркивания__
  • курсив через *звёздочки* или _подчёркивания_ и зачёркивание через ~~две тильды~~
  • цитаты со знаком > в начале строки и маркированные списки со знаком - или *
  • фрагменты кода внутри строки между обратными кавычками
  • ссылки вида [текст](https://example.com), которые открываются в новой вкладке

Например, фасилитатор может вынести решение в заголовок, оформить аргументы списком, выделить ответственного жирным и добавить ссылку на задачу. Такой формат особенно полезен после онлайн-ретроспективы, когда карточки остаются рабочим конспектом встречи.

Одна настройка для карточек и комментариев

Markdown включается отдельно для каждой доски. Откройте настройки, найдите блок «Включить функции» и нажмите плитку «Markdown». По умолчанию функция выключена, поэтому существующие доски продолжают показывать текст как раньше.

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

Настройки доски стали понятнее

Вместе с новой функцией мы изменили порядок плиток в настройках. Сначала идут параметры авторства, перемещения и редактирования карточек. Ниже собраны публичность, дата и ограничение голосов, а форматы содержимого GIFs и Markdown стоят рядом. Пароль, сортировка и нумерация завершают блок. Нужный переключатель проще найти даже на небольшом экране.

Безопасность и ограничения

Это лёгкая разметка, а не полноценный редактор документов. HTML выводится как обычный текст. Кликабельными становятся только ссылки с протоколом HTTP или HTTPS, остальные схемы остаются текстом. Содержимое скрытых карточек по-прежнему маскируется до раскрытия и не выдаётся через форматирование.

  • таблицы, нумерованные и вложенные списки не поддерживаются
  • автоссылки без конструкции [текст](адрес) не создаются
  • картинки через ![](), блоки кода и сырой HTML не обрабатываются
  • незакрытые символы разметки остаются видимым текстом

Как попробовать

  • Откройте нужную доску и перейдите в настройки.
  • В разделе «Включить функции» нажмите плитку «Markdown».
  • Добавьте разметку в карточку или комментарий. Результат появится после сохранения.

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