Document Editor

The editor is where you write and preview Markdown content, add images, embed videos, and format your documents.

Editor layout

The editor is a single live-preview pane. As you type Markdown, headings, code blocks, links, and images render in place. The document title is an editable heading at the top, and a right sidebar holds document info, links, files, and activity. When you select text, a floating toolbar appears with AI, Bold, Italic, Inline Code, Strikethrough, Link, and Magic Link.

Writing and saving

The editor renders a live preview as you type — headings, code blocks, links, and images all appear styled in real time. Your content saves automatically as you type — there is no Save button — and syncs across sessions.

The editor supports standard Markdown plus extensions like task lists, Mermaid diagrams, and wiki-style Magic Links (Wiki Links). For the full syntax reference, see Supported Markdown Syntax.

Tip: Speed up formatting with Keyboard Shortcuts — press Cmd/Ctrl+B for bold or Cmd/Ctrl+I for italic. To add a link, select text and choose Link or Magic Link from the floating toolbar.

Add images

You can add images to a document in three ways.

Upload from your computer:

1. Insert an image block. It shows an empty placeholder titled Add a file.
2. Click Upload and select a file from your computer.
3. The image uploads and renders in place.

Drag and drop:

Drag an image file directly into the editor. It uploads and inserts where you drop it.

From the asset library:

1. Insert an image block.
2. In the placeholder, select From library (or open the image menu and choose Choose from library).
3. In Add from library, pick an existing asset to insert it.

Add videos

Local video files (MP4, WebM, MOV) work the same way as images — drag and drop into the editor, or upload through the file placeholder’s Upload button. Videos render as inline players with controls.

YouTube and Vimeo videos use image syntax with the video URL:

![Watch it you won't regret!](https://www.youtube.com/watch?v=dQw4w9WgXcQ)

External videos appear as a preview card. Click Play to load the embedded player.

Note: YouTube time parameters work too — add ?t=90 or ?t=1m30s to start at a specific point.

Lock a document

Locking marks a page as not-to-be-hand-edited. Turn it on from the More (⋮) menu in the top bar, or from Document Info in the right sidebar; a locked document shows a lock indicator and the editor stops accepting changes.

The important part is what a lock does not stop. It blocks editing from the interface — the CLI and MCP can still write to the document. That makes it the right tool for a page that is generated or synced and should only ever change through that pipeline, and the wrong tool for freezing a document against everyone.

Two consequences worth knowing:

• Restoring an earlier version is refused on a locked document, because a restore is an edit made from the interface like any other. Unlock it first.
• Archiving still works. A locked document can be archived and unarchived — the lock protects a page you are still working on, the archive retires one you are not. They are different states and neither implies the other.

When a document has a merge conflict

If a CLI push or two concurrent edits leave conflict markers in the content, an alert icon appears next to the document in the tree. There is no special resolution mode: open the document, edit the conflicting text into the version you want, and save. The version that sealed the conflict is marked in Version History, so you can see what each side was.

What’s next?

Document Workflow — Manage draft and published states.

Document Visibility & Access Level — Control who can see and access your documents.