Text Blocks

Text blocks are the foundation of every clarife document. Use them to write instructions, add section headers, create step-by-step lists, highlight important notes, and visually separate content.

The default block type. Start typing to add a paragraph. Paragraphs support inline formatting:

💡 Tip: Select text and press Cmd+K (or Ctrl+K) to insert a hyperlink. Paste a URL while text is selected to automatically convert it into a link.

Headings create the structure of your document. clarife supports three levels:

To add a heading, click + and select Heading, then choose the level (H1, H2, or H3) from the dropdown that appears. Headings are a separate block type - there is no # shortcut to create them.

ℹ️ Info: Headings are used by the presentation export to automatically split your document into slides. Each H1 or H2 starts a new slide.

Create unordered lists for non-sequential items. Type - or * followed by a space at the start of a block to begin a bullet list. Press Enter to add the next item. Press Enter on an empty item to exit the list.

Example output:

• First point
• Second point
• Third point

Create numbered lists for sequential steps. Type 1. followed by a space to begin an ordered list. Numbering increments automatically.

Example output:

1. Open the app
2. Click New Document
3. Start writing

💡 Tip: Ordered lists are ideal for step-by-step instructions in tutorials. Each number helps readers track their progress.

A horizontal line that visually separates sections of your document. Click + and select Divider to insert one. Dividers contain no editable content - they are purely visual separators.

Dividers are useful for:

• Separating major sections when you do not want another heading
• Creating visual breathing room between dense content
• Breaking up long tutorials into digestible parts

1. Use headings for structure - Start each major section with an H1 or H2. This helps readers scan the document and enables automatic slide splitting in presentation exports.
2. Keep paragraphs short - Aim for 2-4 sentences per paragraph. In tutorials, shorter paragraphs are easier to follow alongside screenshots.
3. Mix block types - Combine paragraphs with lists and dividers to create variety and improve readability.

Nested (indented) lists are not currently supported. Use separate list blocks or combine items in a single list level.

Yes. Select the block and change its type via the block menu (Heading, then the level). Headings are a separate block type - there is no Markdown shortcut that turns a paragraph into a heading.

There is no enforced character limit per block. However, extremely long paragraphs (10,000+ characters) may slow down rendering.

No. Images are separate screenshot blocks. Place a screenshot block between text blocks to interleave images and text.