Skip to Content
Jolli SpacesEditing

Last Updated: 8/19/2026

Editing & Organizing

Overview

The manual writing surface: the Article editor and the tools for finding and organizing content within a Space. For the AI side - drafting with the Agent, Changesets, and Gap Analysis - see The Jolli Agent.

Prerequisites

  • Contributor access or above to the Space. A Viewer can read Articles and comment threads but cannot edit, post, reply, or resolve.
  • An existing Space with Articles to work on.

The editor

Click any Article to open it. Standard Markdown syntax (#, **bold**, [link](url)) renders live. Folders open the same editor - a Folder can hold its own content.

Floating toolbar

Select text and a small toolbar floats above the selection: bold, italic, underline, strikethrough, inline code, link, blockquote, headings H1–H4, paragraph reset. The toolbar only appears with a selection - nothing always-on at the top of the editor.

There are no list or table buttons. Use Markdown directly (- for a list, pipes for a table); the editor renders them live.

Auto-save

Every edit auto-saves about two seconds after you stop typing - there’s no Save button. Live multi-user editing isn’t supported yet: if two people edit the same Article simultaneously, the last save wins. Use Changesets (via the Jolli Agent or Gap Analysis) for any collaborative writing flow.

Cross-article links

Type [[ to open an inline search popover, type part of another Article’s title, pick it. The link tracks the target Article - if it gets renamed, the link text updates. Cross-Space references need full URL links; the popover only searches the current Space.

Images and uploads

Drag images into the editor (PNG, JPEG, GIF, WebP; 10 MB per file).

For text files, the Folder’s three-dot menu has an Upload File option that creates an Article from the upload. Accepted formats are .md, .mdx, .txt, .json, .yaml, and .yml, up to 1 MB; the resulting Article is fully editable like any other. OpenAPI specs (JSON or YAML) are recognized automatically - drop one in and it renders as an interactive API reference page on the published Site.

Version history

Past versions are browsable from the right-side rail. You can view, copy from, or restore any of them. Restoring creates a new version with the old content; you don’t lose history.

Auto-save does not write a new version every time. Within 30 minutes of the last one, your edits update that same version in place, so a long editing session lands as one entry rather than dozens. After 30 minutes the next save starts a new version. A version is also started whenever a Changeset is pending on the Article, or when the current version came from applying one.

Delete and restore

Soft-delete via the three-dot menu. Articles move to the Space’s Trash and can be restored or permanently deleted from there. Folders move with everything inside them.

Comments

Every Article has a comment thread in the right-side rail. Comments are on the Article as a whole, not anchored to paragraphs - quote in your comment if you need to point at one. You can reply (one level deep), edit or delete your own comments, and @-mention a teammate to notify them. Threads update in real time, and comment activity appears in your Inbox.

Commenting needs edit access to the Space. A Viewer can read a thread but not post, reply, or resolve; attempting it returns “Insufficient permissions to comment in this space”. Contributors and above can comment, and anyone with edit access can resolve a thread or delete someone else’s comment for moderation.

Organizing

Searching within a Space

A search box sits above the Article tree. Start typing and the tree narrows to matching Articles as you go.

  • Search runs a short beat after you stop typing, so you don’t need to press Enter.
  • Click the X in the box, or press Esc, to clear the search and restore the full tree.
  • Search is scoped to the current Space. To find something in another Space, switch to it first (or use a cross-Space URL link, covered above).

Drafts

Article drafts - new Articles you or the Jolli Agent started, plus in-progress edits to existing Articles - collect on a dedicated drafts page, reachable via View all from the drafts list. A draft is standalone until you finish it; it isn’t part of the published Space yet.

  • Each row shows the draft title, a short content preview, when it was last edited, and who created it.
  • The search box filters the list by title and content (case-insensitive).
  • Edit opens the draft in the editor; the trash icon deletes it after a confirmation prompt.

Deleting a draft only discards that unfinished draft - it never touches a published Article.

Getting Started with Jolli SpacesThe Jolli Agent