Block types reference

A page in Claos is made of blocks. This article enumerates every block type the editor supports — 21 in total, grouped into four categories — so you know what's available and when to use which.

For the editing model and the slash menu itself, see Pages and the block editor.

Three ways to insert a block

Slash menu. Type / anywhere in the editor and a menu opens. Start typing to filter — "tabl" jumps to Table, "cal" to Callout. Enter inserts the highlighted item.
Markdown shortcuts. Type Markdown syntax at the start of a line and it converts on the fly — # for Heading 1, - for bullet list, > for blockquote, triple backticks for a code block, and so on.
The + button. A small + appears at the start of empty lines; click it to open the slash menu in place.

Markdown only covers the basic blocks. Advanced, media, and AI blocks are slash-menu only.

Basic blocks

The everyday workhorses — what most pages are made of.

Text. A plain paragraph. The default block when you press Enter.
Heading 1. Large section heading. Use sparingly — typically once per major section.
Heading 2. Medium section heading. The most common heading level.
Heading 3. Small section heading. Don't go deeper than H3 — pages stay scannable.
Bullet list. Unordered list. For items where order doesn't matter.
Numbered list. Ordered list. For sequences — steps, rankings, instructions.
Checklist. Tickable checkboxes inside a page. Useful for to-do lists embedded in a doc.
Blockquote. Indented quoted text. For citations or emphasis.
Divider. Horizontal line. Visual break between sections; cheaper than another heading.
Code Block. Monospaced with syntax highlighting. Pick the language from the block's toolbar — the picker covers a broad set of common languages.

Advanced blocks

Structural blocks that change how content reads.

Toggle. A collapsible block — a chevron at the start expands and collapses what's inside. Good for FAQ-style pages, progressive disclosure, and tucking away long context.
Callout. A highlighted box with an icon. Use for notes, warnings, and tips that need to stand out from prose. Don't overuse — a page full of callouts loses the emphasis.
Table. A grid with a header row. Inline-edit any cell; the table's toolbar adds and removes rows and columns. Best for comparing items along a few attributes.

Media blocks

For everything that isn't text.

Image. Upload from your machine. Drag-and-drop into the editor also works. Images render at full width with a caption if you add one.
File. Attach any file — PDF, DOCX, CSV, ZIP, anything. The file renders as a download card inline. Large files are subject to a per-file size limit set by your plan.
Bookmark. Paste a URL and the editor renders a rich card with the page's title, description, and favicon. Better than a bare hyperlink when the destination is the main point.
Embed. Paste a URL and the editor renders an inline iframe. The supported providers are YouTube, Loom, Figma, and Google Maps. Other URLs won't render as embeds — use a Bookmark instead.

AI blocks

Inline assistance that produces content right where the cursor is.

AI Write. Generate new text. You type a short prompt — "Write a 150-word intro about onboarding" — and the AI drafts directly into the page. Edit the result like any other text.
AI Improve. Rewrite selected text. Tighten a paragraph, change tone, fix awkward phrasing. Select first, then pick AI Improve from the slash menu.
AI Summarize. Condense the selected text. Drop a long paragraph in, get a compact version inline.
AI Translate. Translate the selected text to a chosen language. Pick the language from the prompt that appears.

What isn't a block

A few things that show up in pages but aren't insertable as blocks — useful to know so you don't go looking for them in the slash menu.

Comments are attached to the page (or to a selection of text), not living as a block in the document flow. Use the comment affordance on the right side of the editor.
Page mentions ([[Page name]]) are inline text, not blocks. Type [[ to mention another page and create a hyperlink + backlink.
Person mentions (@name) are also inline text. They send a notification to the person you tag.

Tips and gotchas

One block at a time. The editor doesn't have a multi-select-and-convert flow. To turn five bullets into headings, change them one by one.
Drag to reorder. Hover any block; a handle appears on the left margin. Drag it to move the block up or down — or into an indent inside a list or toggle.
Markdown shortcuts only fire at the start of a line. Typing # heading mid-paragraph won't convert; you need an empty line.
Embeds need a URL the provider serves. For example, a Loom URL works, but a screenshot of a Loom won't. Bookmarks accept any URL.
AI block output is editable. Once an AI block produces text, the result is plain editor content — there's no special "AI block" wrapper to keep or undo.