Edit an article and its screenshots

The article editor is a block editor: type to write, press / to add a block, select text to format it, and use the handle beside each block to move, duplicate or change it. Every change saves on its own. This article covers each part of the editor and everything you can do with screenshots.

Before you start#

• You need edit access to the article. Without it, editing buttons are greyed out and show "You don't have permission to edit". See roles and creator seats and collections for who can edit what.
• The article must have finished generating. While it is being written you can read along, but not edit.

The editor at a glance#

The save status reads Saving… ("Saving your changes"), Unsaved ("Your changes will save in a moment"), Saved ("All changes saved") or Not saved when a save failed. There is no Save button.

When teammates have the article open, their pictures show in the top bar under "People in this article", each marked Editing or Viewing. See Write an article together with your team.

When the article opens#

The article shows right away, read-only, while the editor connects to live editing. A second or two later it becomes editable in place. If you already clicked into the text, what you type in that moment carries over once the article is editable. If connecting takes longer, a note says "Connecting to the live article… You can read it meanwhile."

Write and format text#

1. Add a block#

   On an empty line, type / to open the block menu, then keep typing to filter it. Use ↑ and ↓ to choose, Enter to insert and Esc to close. See Blocks you can add.

   

2. Format a selection#

   Select text to open the formatting bar: Ask AI (⌘J or Ctrl+J), Turn into (shows the current block type, such as Text), Bold, Italic, Strikethrough (⌘⇧S), Code (⌘E) and Link (⌘K). On Windows use Ctrl instead of ⌘.

3. Rearrange blocks#

   Hover a block to show its handle on the left: "Drag to move · Click for options". While you drag, a line shows where the block lands, including inside callouts, steps, tabs and lists. The + next to it adds a block: "Click to add below · ⌥-click to add above" (Alt-click on Windows).

4. Use the block menu#

   Click the handle for the block's menu:

   Item	Shortcut (Mac / Windows)
   Ask AI
   Turn into (Text, Heading 2–4, Bulleted list, Numbered list, Quote, Code, Callout)
   Duplicate	⌘D / Ctrl+D
   Move up / Move down	⌘⇧↑ / ⌘⇧↓, Ctrl+Shift+↑ / Ctrl+Shift+↓
   Copy as Markdown
   Copy link to heading (headings only)
   Delete	⌫ / Del

5. Undo a change#

   Press ⌘Z (Mac) or Ctrl+Z (Windows) to undo, ⇧⌘Z or Ctrl+Shift+Z to redo, or use the arrows in the top bar. For older versions, open revision history.

Blocks you can add#

There is no Heading 1: the article's title is its only top-level heading.

• Clevera video asks you to "Paste a Clevera share link". See Show a video in an article.
• Embed asks you to "Paste a YouTube, Vimeo or Loom link".
• Video file needs an https link to a video file. Its toolbar has Autoplay, Loop, Mute, a caption and Download video.

Tables#

Table opens a size picker; choose the rows and columns. Every table has a Header row: "Markdown tables always start with a header row, so it stays first and can't be deleted."

Hover a row or a column to get its handle ("Row options (drag to move)" or "Column options (drag to move)"). Drag it to move the row or column, or click it for Insert row above / Insert row below, Insert column left / Insert column right, moving, Sort ascending / Sort descending, alignment, Duplicate, Delete row / Delete column, Clear contents and Delete table. Add a row and Add a column sit at the table's edges.

Write with AI#

The editor has its own AI menu for the spot you're working on: rewrite a paragraph, fix a step against the recording, add a screenshot from the recording, or write what comes next. Open it with ⌘J (Ctrl+J), with Space on an empty line, with Ask AI in the formatting bar or from a block's menu.

Each request uses credits, listed as Article AI in your credit activity. See Use AI in the article editor for every action and how to review the result.

Work with screenshots#

Click a screenshot to select it. Its toolbar has:

Replace or add a screenshot#

Replace image, or the Image block, opens Select Image with four tabs:

Capture a frame with your own markers#

Capture from Video lets you take a screenshot from any moment of the source recording and highlight what matters.

1. Find the moment#

   Play the video or drag along the timeline. Use Previous frame and Next frame to step one frame at a time.

2. Draw on it#

   Under Marker, pick Rectangle, Circle or Arrow and drag on the video. Pick a Color, a Fill for rectangles and circles (None, Light, Medium or Strong) and a Thickness. Select a shape and press Delete to remove it, or use Clear all.

3. Crop it if you like#

   Pick Crop: "Drag on the video to choose the area to keep — everything outside the box is removed."

4. Capture#

   Click Capture this frame. With markers or a crop the button reads, for example, Capture with 2 markers + crop. The new screenshot goes into the article.

   

Capture from Video appears only when the article has a source video.

Languages#

Each language of an article is a separate copy with its own text, screenshot captions and history. Switch with the Language menu in the top bar; Original marks the language it was written in. To add a language, choose Translate…. Edits you make in one language don't change the others.

Right-to-left languages#

Articles in Arabic, Hebrew, Persian, Urdu, Pashto and Sindhi read right to left. Clevera sets the direction from the language of each copy, so there's nothing to switch: an English original and its Arabic translation each read the right way.

See Export or publish an article for every download format.

Troubleshooting#

Related#