Редактор и слеш-команды

Зачем это нужно

Редактор Nextdocs — это то, где вы фактически пишете документацию.
Он построен на TipTap / ProseMirror, работает как Notion или
Confluence: печатаете обычный текст, по мере необходимости добавляете
структурированные блоки (заголовки, списки, код, таблицы, диаграммы).

Ключевое отличие — всё живёт в реальном времени. Ваш коллега видит,
как вы печатаете, через ту же страницу; ваш курсор виден ему,
его — вам. Никаких «Save» кнопок — всё синхронизируется автоматически.

Где открыть

Откройте любую страницу проекта (кликните по названию в дереве слева)
— вы сразу окажетесь в редакторе. Заголовок страницы редактируется
прямо в тексте (первая строка — # Заголовок), содержимое — ниже.

Как форматировать

Базовые клавиатурные сочетания

Работают стандартные markdown-сокращения:

Ввод

Результат

# в начале строки

Заголовок 1-го уровня

## , ###

Заголовки 2-го и 3-го уровней

**жирный** или Cmd/Ctrl+B

жирный

*курсив* или Cmd/Ctrl+I

курсив

`моно`

моноширинный

> цитата

Блок-цитата

- пункт или 1. пункт

Маркированный / нумерованный список

[ ] задача

Чек-лист

--- на пустой строке

Горизонтальная линия

Ctrl/Cmd+Z — undo, Ctrl/Cmd+Shift+Z — redo. История работает
локально внутри одной сессии: недавние шаги можно откатить, но если
вы закрыли страницу, откатиться через Ctrl+Z нельзя — для этого
используйте вкладку History в правой панели (см.
History).

Слеш-команды (меню «/»)

Введите / в пустой строке — появится меню со всеми доступными
блоками. Можно печатать название (например, /table или /code)
чтобы отфильтровать список. Стрелки ↑/↓ для выбора, Enter для
вставки.

Что доступно:

Упоминания @

Введите @ в любом месте текста — откроется попап со списком людей
из проекта. Выберите коллегу — в тексте появится чип @Имя, и этому
человеку придёт уведомление. Подробнее — Comments & mentions.

Ссылки

Выделите текст, нажмите Cmd/Ctrl+K — введите URL. Или просто
вставьте URL рядом с выделенным текстом — он автоматически превратится
в гиперссылку. При ховере появится мини-попап с превью и кнопками
«Редактировать» / «Удалить».

Если вставляете ссылку на другую страницу Nextdocs (формат
/projects/42/17) — при переходе получатель попадёт прямо туда.

Вставка из буфера обмена

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

Google Docs / Word / Pages

Скопировал абзацы из Google Docs — вставил в Nextdocs. Сохраняется:

Что теряется:

Notion

Копируете страницу (или любой блок) из Notion → вставляете.
Поддерживаются:

Что теряется: Notion-специфичные базы данных (database views),
embed'ы Figma / Miro (ссылка остаётся, рендеринг — нет), pages-as-
relations (превращаются в ссылки).

HTML

Любой HTML из браузера — статьи, Confluence, внутренние портальные
страницы, web-архивы. Парсится та же грамматика, что и Google Docs:
заголовки, списки, таблицы, ссылки, изображения, <code>, <pre>.

Если HTML содержит сложные атрибуты (inline-CSS, style="..."),
они нормализуются под нашу тему. Скрипты и iframe'ы — удаляются из
соображений безопасности.

Markdown

Копируете .md файл, блок из ChatGPT, или pre-formatted markdown —
превращается в полноценные блоки:

Если текст в буфере — сырой markdown без разметки распознавания,
всё равно попробуем найти markdown-синтаксис и его конвертировать.
Если не нашли — вставится как plain text.

Таблицы из Excel / Google Sheets / Numbers

Скопировали диапазон ячеек в Excel — вставили в Nextdocs. Получаете
нашу таблицу с правильными колонками/строками. Сохраняется:

Теряется:

Подробнее про таблицы — Tables.

CSV / TSV

Специальный случай таблиц. Если в буфере текст с запятыми или
табуляцией в стандартной структуре строк/колонок — парсер
автоматически распознаёт CSV/TSV и создаёт таблицу. Используется,
например, для вставки данных из curl | jq -r, из экспорта БД, из
логов.

Скриншоты и изображения

Поддерживаются: PNG, JPEG, GIF, WebP, SVG. Вес — до 20 MB на файл.

PDF

Вставить PDF через буфер обмена нельзя (он бинарный), но есть
импорт PDF на уровне страницы:

Подробнее — Integrations → PDF.

ZIP / архивы

Перетаскиваете ZIP в окно — появится меню «Upload attachment / Try
to import as repository». Второй вариант работает только на уровне
проекта (создаёт страницы из содержимого) — Integrations.

Умная нормализация

Одна из главных идей редактора — вы копируете откуда угодно, и
всё становится частью единой типографики Nextdocs. Никаких
«ой, шрифт другой», «ой, размер заголовка не тот». Копируйте
спокойно — приведение к стилю автоматическое.

То же работает наоборот: когда копируете из Nextdocs в Word /
Slack / Notion / email — получатель увидит нормально
отформатированный кусок, не HTML-помойку.

Drag&drop

Поиск и замена

Cmd/Ctrl+F открывает строку поиска в текущей странице. Работает
как в любом редакторе: совпадения подсвечиваются, Enter переключает
между ними. Cmd/Ctrl+Shift+F переключает в режим поиска с заменой
(если у вас есть права на редактирование).

Cmd/Ctrl+K — открывает глобальный поиск + AI-агент (подробно:
Search и AI Agent).

Оглавление (ToC) и TL;DR

Правая панель в редакторе содержит несколько вкладок:

Ограничения