Skip to Content
Jolli SpacesEditing

Last Updated: 9/2/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.

Article outline

Alongside the editor is a column of small bars, one per heading, down to the fourth level. Hover it and it expands into an On this page list; click any entry to jump straight to that section. On a long Article it is the fastest way to move around without scrolling, and it doubles as a quick check that your heading structure reads sensibly.

Published Sites

The Article header carries a globe icon with a count next to it, showing how many Sites currently include the Article you have open. Click it and the list splits into Public and Internal, so you can tell at a glance whether what you are editing is already live and who can see it. An Article that belongs to no Site shows nothing.

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