Skip to main content
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.

​
Paragraph

The default block type. Start typing to add a paragraph. Paragraphs support inline formatting:
FormatShortcut (macOS)Shortcut (Win/Linux)Markdown shortcut
BoldCmd+BCtrl+B**text**
ItalicCmd+ICtrl+I*text*
LinkCmd+KCtrl+K—
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

Headings create the structure of your document. clarife supports three levels:
LevelUsageMarkdown shortcut
H1Main section title# at line start
H2Subsection## at line start
H3Sub-subsection### at line start
To add a heading, click + and select Heading, then choose the level from the dropdown that appears. Alternatively, type #, ##, or ### followed by a space at the beginning of a new block to auto-convert it to a heading.
Headings are used by the presentation export to automatically split your document into slides. Each H1 or H2 starts a new slide.

​
Bullet List

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

​
Ordered List

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
Ordered lists are ideal for step-by-step instructions in tutorials. Each number helps readers track their progress.

​
Blockquote

Use blockquotes to highlight important notes, tips, or warnings. A blockquote renders as indented text with a colored left border. To create a blockquote, click + and select Blockquote, or type > followed by a space at the start of a block.

​
Divider

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

​
Text Block Tips

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, blockquotes, 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. You can also clear the text, type ## at the beginning, and the block will convert.
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.