Rich text
Write headings, paragraphs, lists and links together in one editable text block.
Code name: Markdown · Category: Text
Registered in the live renderer. Website context and the limitations below still apply.
When to use it
Use rich text for an introduction, service description or article. It keeps related text together while preserving heading and list structure.
In the editor
- Select the text block and edit its content.
- Use real headings and lists for structure.
- Choose content rhythm and heading width if the text needs more breathing room.
Example
This example uses illustrative content. Media placeholders must be replaced with your own assets; data-backed blocks need the normal website context.
<Markdown contentRhythm="balanced" headingWidth="Medium">
## A clearer plan for your business
Start with a focused conversation about your goals.
- Understand your priorities
- Agree on the next step
</Markdown>Behaviour and limitations
- Content belongs inside the Markdown element, not in a text prop.
- contentRhythm changes spacing between text elements. none preserves the existing appearance.
- headingWidth controls heading line width. Full keeps the existing width; narrower settings can change wrapping.
Property reference
Types below describe the editor controls and known choices, not every value accepted by the renderer. A renderer default is extracted from its parameter; an editor-only default does not prove the runtime default. “Not declared here” does not mean required. Preserve omitted values unless the requested edit needs them.
| Property | Editor value type | Default evidence | Guidance |
|---|---|---|---|
backgroundColor | string | "transparent" (editor only) | Background colour. Theme-derived appearance can still depend on the surrounding section. |
spacing | object | {} (renderer) | An object of spacing settings. Preserve existing responsive values when changing a single setting. |
animationType | "none", "fade-up", "fade-down", "fade-left", "fade-right", "flip-up", "flip-down", "flip-left", "flip-right", "zoom-in", "zoom-left", "zoom-right" | "" (renderer) | Entrance animation setting. Use a supported editor value; preserve it for unrelated edits. |
screenList | string | "" (renderer) | Comma-separated device names to hide on: mobile, tablet, desktop. An empty string hides on none. |
alignVertical | See guidance | Not declared here | Vertical alignment within the surrounding layout. |
contentRhythm | "none", "compact", "balanced", "roomy" | "none" (renderer) | Content rhythm. See the usage notes for this block. |
headingWidth | "Full", "Narrow", "Medium", "Wide" | "Full" (renderer) | Heading Width. See the usage notes for this block. |
css | string | Not declared here | Custom CSS text. Preserve unrelated rules and prefer the dedicated property for supported edits. |
children | See guidance | Not declared here | Nested content between the opening and closing tags. Follow the block-specific example. |
