Using the Editor

The Editor is the core writing surface in the product. It opens when you create or select a document inside a project. It provides a live Markdown editing experience with real-time collaboration.

Opening the editor

Navigate to a project, then click on an existing document or create a new one. The editor opens in the main area with the document content ready to edit.

The editor interface

The editor is built on CodeMirror, providing a familiar code-editing experience. You type Markdown on the left and see a live preview on the right (depending on your view settings). The toolbar at the top provides quick access to common formatting actions.

Writing and formatting

You write in Markdown, a lightweight markup language. As you type, the editor provides syntax syntax highlighting and live rendering. Use the toolbar or the context menu to format text, insert links, create lists, and more.

Real-time collaboration

When multiple people open the same document, their changes appear in real time. You can see who else is currently viewing or editing the document. Collaboration is powered by Yjs, which synchronizes changes across all connected users.

The editor supports multiple open documents as tabs. You can switch between tabs, close them, and reorder them. Each tab represents a separate document (node) within the project.

Quick Switcher

By default, press Ctrl+K on Windows/Linux or ⌘K on macOS to search active files in the current project by title or path. You can change or disable this personal shortcut in Settings → Hotkeys. Use the arrow keys and Enter to open a file; Escape or clicking outside closes the switcher without changing the current document. The switcher is a read/navigation affordance for project members, including viewers, and does not provide editing or other mutation permissions.

Hotkeys catalog

Settings → Hotkeys lists the commands available in the current Zelares catalog. Use All, Assigned, Unassigned, or Customized to filter the list, and combine a filter with search. A command may have multiple bindings; clearing a command removes its effective bindings, while Reset restores the current source defaults. Hotkey preferences are personal and browser-local. Some Project, file-tree, and editor actions are listed with their existing owner but remain unavailable until a safe owner adapter is available; they do not create global handlers or change permissions.

View and editing options

Use the editor options controls to switch between reading, editing, and source modes. For details, see Views and editing mode.

Saving

Changes are saved automatically as you type, so there is no manual Save button. Saving happens asynchronously after a short delay, with transient failures retried. If persistence ultimately fails, your latest edits may not be durable.

For a full overview of supported Markdown formatting, see Markdown Basics. For every formatting action available from the right-click menu, see Context Menu. To switch between reading, editing, and source modes, see Views and editing mode.