Editor and slash commands

Why it matters

The Nextdocs editor is where you actually write documentation. It's
built on TipTap / ProseMirror and works like Notion or Confluence:
type plain text, add structured blocks (headings, lists, code, tables,
diagrams) as you go.

The key difference is that everything is live. Your colleague watches
you type in the same page; your cursor is visible to them, theirs to
you. No "Save" buttons — everything is synced automatically.

How to open it

Open any page in a project (click its name in the tree on the left) —
you're immediately in the editor. The page title is edited in-place
(first line — # Title), the body follows.

How to format

Basic keyboard shortcuts

Standard markdown shortcuts work:

Input

Result

# at the start of a line

H1 heading

## , ###

H2 / H3 headings

**bold** or Cmd/Ctrl+B

bold

*italic* or Cmd/Ctrl+I

italic

`mono`

monospace

> quote

Block quote

- item or 1. item

Bulleted / numbered list

[ ] task

Checklist

--- on a blank line

Horizontal rule

Ctrl/Cmd+Z — undo, Ctrl/Cmd+Shift+Z — redo. History is local to the
current session: recent steps can be rolled back, but once you close
the page, Ctrl+Z is no longer enough — use the History tab in the
right panel (see History).

Slash commands (/ menu)

Type / on an empty line — a menu of every available block pops up.
You can type the name (e.g. /table or /code) to filter. Arrow keys
↑/↓ to select, Enter to insert.

Available blocks:

@ mentions

Type @ anywhere — a popover opens with people in the project. Pick
a colleague — an @Name chip appears in the text, and the person is
notified. Details — Comments & mentions.

Links

Select text, press Cmd/Ctrl+K, paste a URL. Or just paste a URL next
to selected text — it auto-converts to a hyperlink. Hover shows a mini
popover with preview and Edit / Remove buttons.

If you paste a link to another Nextdocs page (format
/projects/42/17) — the reader lands directly on it.

Pasting from the clipboard

The editor tries to interpret what you paste intelligently. It guesses
the format and normalises it to its own schema — no settings, no
plugins. Details below.

Google Docs / Word / Pages

Copy paragraphs from Google Docs, paste into Nextdocs. Preserved:

Lost:

Notion

Copy a page (or any block) from Notion → paste. Supported:

Lost: Notion-specific databases (database views), Figma / Miro
embeds (link stays, rendering doesn't), pages-as-relations (turn
into links).

HTML

Any HTML from a browser — articles, Confluence, internal portal
pages, web archives. Same grammar as Google Docs: headings, lists,
tables, links, images, <code>, <pre>.

If the HTML contains complex attributes (inline CSS, style="..."),
they're normalised to our theme. Scripts and iframes are removed
for security.

Markdown

Paste a .md file, a block from ChatGPT, or any pre-formatted
markdown — it becomes proper blocks:

If the clipboard has raw markdown without explicit signals, we still
try to detect markdown syntax and convert it. If nothing matches —
pasted as plain text.

Tables from Excel / Google Sheets / Numbers

Copy a range of cells in Excel, paste into Nextdocs. You get our
table with proper columns/rows. Preserved:

Lost:

More on tables — Tables.

CSV / TSV

A table special case. If the clipboard contains comma- or
tab-separated text in a standard rows-columns shape — the parser
auto-detects CSV/TSV and creates a table. Handy for pasting from
curl | jq -r, database exports, logs.

Screenshots and images

Supported: PNG, JPEG, GIF, WebP, SVG. Up to 20 MB per file.

PDF

PDF can't be pasted through the clipboard (it's binary), but there's
a PDF import at the page level:

More — Integrations → PDF.

ZIP / archives

Drop a ZIP into the window — a menu appears: "Upload attachment /
Try to import as repository". The second option only works at the
project level (creates pages from the archive contents) —
Integrations.

Smart normalisation

A central idea of the editor: you paste from anywhere, and
everything becomes part of Nextdocs's unified typography. No "the
font is off", "the heading size is wrong". Paste freely — styling is
homogenised automatically.

The same works in reverse: when you copy from Nextdocs into Word
/ Slack / Notion / email — the recipient sees a properly formatted
chunk, not an HTML mess.

Drag & drop

Find and replace

Cmd/Ctrl+F opens a search bar in the current page. Works like any
editor: matches are highlighted, Enter jumps between them.
Cmd/Ctrl+Shift+F switches to find-and-replace (if you have write
access).

Cmd/Ctrl+K — opens global search + AI agent (details:
Search and AI Agent).

Table of contents (ToC)

The right panel in the editor has several tabs:

Limitations