DoskaДокументация
Документация / Работа в Doska

Презентации

Слайды рядом с досками и документами — из доски, документа или шаблона, с живыми диаграммами по шагам, графиками, режимом докладчика, PDF и PowerPoint.

Презентации — это слайды, которые лежат в тех же проектах и папках, что доски и документы. Они сделаны для инженерных выступлений: архитектурных ревью, разборов инцидентов, демо и онбординга. На слайде может быть диаграмма из кода или живой кусок доски, и её можно показывать клик за кликом: презентация объясняет систему и не устаревает, когда система меняется. Все, у кого презентация открыта, видят правки сразу.

Создать презентацию

На главной нажмите Презентация или на странице проекта Создать → Презентация. В окне можно выбрать:

  • Пустая: титульный слайд и слайд с пунктами.
  • Шаблоны: архитектурное ревью, разбор инцидента, демо спринта, техдоклад, онбординг в команду, предложение (RFC), питч продукта и еженедельный апдейт. У каждого своя тема, и они показывают, что умеют слайды: диаграммы по шагам, большие числа, графики, таймлайны, таблицы.
  • Из доски: каждый фрейм доски станет слайдом с этой частью доски, каждая диаграмма — слайдом, который показывается по шагам. Тексты стикеров во фрейме станут заметками докладчика.
  • Из документа: разделы станут слайдами, длинный текст уйдёт в заметки докладчика, списки разобьются на слайды до шести пунктов, а диаграммы, таблицы, код и цитаты получат свои слайды.

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

Делать и править презентации умеет и ИИ-агент через MCP.

Темы и макеты

Вид всей презентации задаётся кнопкой Тема в верхней панели. Тем восемь: Doska, Midnight, Aurora, Paper, Mono, Ocean, Sunset и Forest. Тема задаёт шрифты, цвета и фоны, и при смене все слайды следуют за ней. Диаграммы на слайдах тоже берут цвета темы (переключите диаграмму на Как на доске, чтобы оставить её цвета).

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

Редактирование

Панель над слайдом вставляет:

  • Текст: заголовок, подзаголовок, основной текст, список, цитату, большое число, подпись или надзаголовок. Двойной клик — редактировать. Внутри работают **жирный**, *курсив* и `код`. Слишком длинный для своей рамки текст уменьшается, чтобы поместиться.
  • Картинку: загрузите файл или вставьте из буфера обмена.
  • Фигуру и иконку: прямоугольники, капсулы, круги, линии и стрелки, те же облачные и технические иконки, что на досках.
  • Диаграмму из кода: Mermaid, D2 или nwdiag, рисуется так же, как на досках. Ошибки показываются под кодом сразу.
  • Диаграмму с доски: живую диаграмму, фрейм или всю доску из проекта. Это не скриншот: когда доска меняется, меняется и слайд.
  • Код: блок кода с подсветкой синтаксиса.
  • График: столбцы, горизонтальные столбцы, линия, область, круговая или кольцевая диаграмма в цветах темы. Числа правятся маленькой таблицей в панели справа.
  • Блоки: большие числа, таймлайн, шаги процесса, карточки и таблицы. Пункты правятся строками вида Заголовок: текст.

Картинка на фоне (в панели справа, когда ничего не выделено) ставит картинку за весь слайд; Приглушить сохраняет текст поверх неё читаемым.

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

Слайды в списке можно перетаскивать. Под слайдом пишутся заметки докладчика: их видите только вы, в режиме докладчика.

КлавишиДействие
F5 / Shift+F5Показ с первого / текущего слайда
⌘/Ctrl+Z, ⌘/Ctrl+Shift+ZОтменить, повторить
⌘/Ctrl+DДублировать
⌘/Ctrl+C, ⌘/Ctrl+VКопировать и вставить элементы
DeleteУдалить выделенное
СтрелкиСдвиг на 1 px, с Shift на 10 px
EnterРедактировать выделенный текст

Клики внутри слайда

Во время показа слайд может раскрываться клик за кликом:

  • Показ диаграммы по шагам. Выделите диаграмму и выберите По шагам в разделе Показ по шагам: каждый клик показывает следующую часть схемы, по стрелкам. Приблизить притушает всё остальное и по очереди приближает группы (subgraph). Свой порядок задаётся id узлов из кода: user, api | db (группы через |).
  • По клику. Любой элемент может появляться своим кликом, а не вместе со слайдом.
  • Код. Строки для подсветки по кликам, например 1-3|5: группы подсвечиваются по очереди, остальной код притухает.

Если на слайде есть клики, под ним появляется панель, чтобы проверить их прямо в редакторе.

Презентация в Markdown

Кнопка Markdown в верхней панели показывает всю презентацию текстом рядом со слайдами. Правьте её там, вставьте презентацию, которую написал ИИ-агент, или скопируйте её. Слайды, текст которых вы не меняли, сохраняют ручную раскладку; изменённые раскладываются заново. Синтаксис описан ниже.

Показ

Нажмите Презентовать (или F5; Shift+F5 — с текущего слайда). Презентация откроется на весь экран с выбранными переходами и анимациями. Стрелки, пробел, клик или пульт для презентаций сначала проходят клики слайда, потом переходят к следующему.

КлавишиДействие
→, Пробел, PageDown, кликСледующий клик или слайд
←, PageUpНазад
Home / EndПервый / последний слайд
BЧёрный экран
LЛазерная указка
EscВыйти

Режим докладчика (в меню или кнопкой во время показа) открывает второе окно: текущий слайд, что покажет следующий клик, заметки, таймер и часы. Оставьте его на экране ноутбука, а слайды выведите на проектор — окна переключаются вместе.

Когда кто-то показывает презентацию, у остальных, у кого она открыта, появляется плашка: можно нажать Следовать, и на экране будет тот же слайд и тот же клик. Зрители по публичной ссылке видят такую же плашку (Смотреть). Те, кто следит за показом, могут отправлять реакции (👏 🔥 ❤️ 😂 🤯 ❓) — они всплывают на экране докладчика.

Скачать и поделиться

  • Скачать PDF: по странице на слайд, с чётким векторным текстом и диаграммами. В окне печати выберите Сохранить как PDF.
  • PowerPoint (.pptx): текст, фигуры, картинки, таблицы и графики остаются редактируемыми в PowerPoint, Keynote или Google Slides; диаграммы и блоки приходят чёткими картинками, заметки докладчика сохраняются.
  • Этот слайд в PNG или Скопировать слайд картинкой: для чата или документа.
  • Markdown: скачайте или скопируйте презентацию в Markdown, чтобы хранить её в git или отдать ИИ-агенту.
  • Поделиться: пригласите людей только в эту презентацию или включите публичную ссылку. По ссылке слайды видны без входа, их можно показать на весь экран, смотреть ваш показ вживую и скачать в PDF. Добавьте к ссылке ?present, чтобы она сразу открывалась в режиме показа.

История версий работает так же, как у досок и документов: снимки сохраняются сами, любой можно восстановить.

Движение: морфинг и magic move

  • Морфинг. Выберите переход Морфинг (для всей презентации или На этот слайд), продублируйте слайд и измените копию: подвиньте элементы, поменяйте размер, отредактируйте код диаграммы. Во время показа всё, что есть на обоих слайдах, плавно перетекает на новое место; узлы диаграммы переезжают туда, где их поставила новая раскладка, а новые проявляются — «было → стало» без единой стрелки. В Markdown: <!-- transition: morph -->.
  • Magic move. Блок ````md magic-move с несколькими блоками кода показывает, как код меняется по кликам: неизменные строки плавно переезжают, новые появляются.

Медиа, формулы и живой код

  • Медиа на панели вставляет видео YouTube, Vimeo или Loom, видеофайл или любую страницу https (Grafana, Figma, живое демо). Страницы и плееры живые во время показа. Видео можно поставить и фоном слайда.
  • Фото находит бесплатные картинки (общественное достояние и Creative Commons из Wikimedia Commons) и добавляет подпись с автором, где этого требует лицензия.
  • Формулы: $$ … $$ — отдельной строкой, $ … $ — внутри текста (KaTeX).
  • Запуск кода: включите Можно запустить во время показа у блока JavaScript или TypeScript, и на слайде появится кнопка Запустить с выводом прямо под кодом. Код выполняется в песочнице, отдельно от Doska и вашего аккаунта, и останавливается через пять секунд.

Зал

  • Подключение по QR-коду. Во время показа кнопка QR показывает код публичной ссылки: зрители смотрят слайды на телефонах, без регистрации.
  • Вопросы. Зрители задают вопросы и голосуют за них; вы видите их на панели вопросов и отмечаете отвеченные.
  • Опросы. Слайд с опросом (```poll в Markdown: вопрос, затем варианты) собирает голоса с телефонов, столбики растут прямо на слайде.
  • Реакции. Зрители отправляют 👏 🔥 ❤️ 😂 🤯 ❓, и они всплывают на экране докладчика.

Инструменты показа

КлавишиИнструмент
P / H / EПеро, маркер, стереть рисунок (зрители видят его тоже)
Z / SЛупа, прожектор
GВсе слайды, чтобы перейти к любому

На панели показа есть ещё камера в кружке (ваша камера поверх слайдов — для демонстрации экрана), запись (доклад с голосом и камерой сохраняется видеофайлом), автопоказ (каждые 5, 10 или 20 секунд, по кругу) и пульт на телефоне (QR-код: большие кнопки, заметки и таймер). Режим докладчика работает и сам по себе: листайте слайды, чтобы отрепетировать, а затем нажмите Начать показ.

Поделиться, встроить, прочитать

  • Встраивание: при включённой публичной ссылке Скопировать код для встраивания даёт iframe для Notion, Confluence, вики или сайта. В документах Doska выберите презентацию в Диаграмма с доски, и её можно листать прямо в документе.
  • Читать лентой: публичная ссылка показывает слайды один под другим (по желанию — с заметками); на телефонах она открывается так сразу.
  • Пароль и срок: защитите публичную ссылку паролем или дайте ей работать день, неделю или месяц.
  • Просмотры: кто открывал ссылку, сколько времени провёл на каждом слайде и докуда досмотрел.
  • Ещё экспорт: PDF со всеми кликами, PDF с заметками докладчика (раздатка) и HTML-файл, который работает без интернета.

Бренд, подвал и проверка

  • Тема → Ваш бренд: ваши два цвета и шрифты поверх любой темы.
  • На каждом слайде (панель, когда ничего не выделено): текст подвала, логотип и номера слайдов.
  • Проверить презентацию (меню) находит слабый контраст, мелкий текст, картинки без описания, перегруженные слайды и то, что вылезает за край.

Импорт и git

  • Импорт PowerPoint в окне новой презентации превращает .pptx в слайды: текст, картинки, таблицы, заметки и цвета файла.
  • Презентации могут жить в git: файл *.slides.md (или с marp: true в начале), синхронизированный через документы из git, становится презентацией. Слайды, которые вы не меняли в файле, сохраняют раскладку, сделанную в Doska.

Формат Markdown

Презентацию можно написать в Markdown: в этом формате её показывает панель Markdown, и так с ней работают ИИ-агенты через MCP.

markdown
---
theme: midnight
transition: fade
---

# Платёжная платформа
Архитектурное ревью, Q4

---

## Цифры сейчас
- **1,2k** запросов в секунду
- **340 мс** задержка p99
- **99,9%** доступность

---

## Как идёт запрос
```mermaid steps
flowchart LR
  user --> api --> queue --> worker --> db[(Postgres)]
```

<!-- notes: каждый клик подсвечивает следующее звено -->

---

## Запросов в день
```chart line
День, Запросы
Пн, 120
Вт, 180
Ср, 260
```

---

## План
```timeline
Неделя 1: Очередь и воркеры
Неделя 3: Двойная запись
Неделя 5: Переключение
```
  • --- на отдельной строке начинает новый слайд. Необязательный блок в начале задаёт тему и переход (none, fade, slide или zoom).
  • # Заголовок — титульный слайд (первый) или слайд раздела; <!-- layout: closing --> перед ним делает финальный слайд по центру.
  • ## Заголовок со списком или абзацем — слайд с текстом. Пункты, которые начинаются с жирного числа (- **99,9%** аптайм), становятся большими числами. <!-- column --> делит текст на две колонки.
  • > цитата — слайд с цитатой; строка после неё станет подписью.
  • Блок ```mermaid, ```d2 или ```nwdiag — слайд с диаграммой. Добавьте steps после языка, чтобы показывать её по шагам, steps:focus — чтобы приближать группы по очереди, или steps=a,b|c для своего порядка.
  • Блок ```doska со строками board: <id> и, если нужно, diagram: <id> или frame: <id> показывает доску вживую (с теми же вариантами steps).
  • Блок ```chart — график: type: (bar, hbar, line, area, pie, donut, можно и после слова chart), необязательный unit:, затем строка заголовков и по строке на подпись.
  • Блоки ```metrics, ```timeline, ```process и ```cards со строками Заголовок: текст — готовые блоки.
  • Таблица Markdown — слайд с таблицей.
  • Остальные блоки кода остаются кодом; ```ts {1|3-4} подсвечивает эти строки по кликам.
  • ![](https://…) — слайд с картинкой. ![bg](https://…) ставит картинку на фон слайда; ![bg 60](…) приглушает её на 60% (![bg 0](…) — без приглушения). Картинки — это адреса https или файлы, загруженные в Doska (/api/files/…).
  • <!-- notes: … --> добавляет заметки докладчика; <!-- background: bold --> даёт слайду яркий фон темы.