> For the complete documentation index, see [llms.txt](https://docs.api.intratool.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.intratool.de/introduction/rich-text.md).
# Rich Text
Rich-text fields accept and return HTML strings. intratool uses TipTap as its editor, but TipTap JSON is an internal editing representation and is not part of the API or database contract.
Use the canonical markup below so content can be opened, changed, and serialized by the editor without losing structure. Individual fields can expose only a subset of the general editor features; the affected resource page remains authoritative for whether a field accepts rich text and whether it is nullable.
## API Values
Send the complete HTML document fragment as a JSON string. A request library handles JSON escaping; the value itself remains HTML.
```json
{
"text": "
Welcome to the project.
"
}
```
Responses return the same field as an HTML string. Do not send TipTap JSON documents, arrays of nodes, Markdown, or editor state.
## Document Structure
Wrap every prose block in a paragraph. Use an empty paragraph only for an intentional blank line between non-empty blocks, and use ` ` only for a line break within the same paragraph.
```html
First paragraph.
Second paragraph. Same paragraph, new line.
```
Do not submit bare text such as `First paragraph.` when the field accepts rich text. An entirely empty editor is represented as `null` when the resource field is nullable; an empty paragraph is not a substitute for a required value.
## Inline Formatting
| Format | Canonical HTML |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| Bold | `Bold text` |
| Italic | `Italic text` |
| Underline | `Underlined text` |
| Strikethrough | `Removed text` |
| Text color | `Red text` |
| Background color | `Highlighted text` |
| Font size | `Large text` |
| Small text | `Small text` |
| Emoji | `✅` as a Unicode character |
Formatting marks can be nested inside a paragraph. Keep the block structure outside the marks.
```html
Important: Submit the signed document.
```
## Blocks and Alignment
Headings use `
` through `
`. Paragraphs and headings can select one of the supported [Text Alignments](#text-alignments) through `text-align`.
**Text Alignments**
* `left` - Aligns content with the left edge.
* `center` - Centers the content horizontally.
* `right` - Aligns content with the right edge.
* `justify` - Distributes content across the available width.
```html
Safety Instructions
Read every step before starting the machine.
Stop the machine before opening the cover.
```
A horizontal rule can additionally use one of the height classes `hr-height-2` through `hr-height-5` and a hexadecimal background color, for example ``.
## Lists
Use `
` for unordered lists and `` for ordered lists. Wrap textual list-item content in paragraphs, including nested list items.
```html
Inspect the work area.
Check the equipment.
Confirm the serial number.
Record the condition.
```
An ordered list can set a non-default starting number with the `start` attribute, for example ``.
## Links and Shared Items
Use a normal anchor for a text link. Use the resource's API-provided `static_url` for an internal link instead of constructing a frontend path; internal URLs should be relative and open in the same window. External URLs should use a new window and the protective relation values shown below.
```html
```
Add `data-show-url-context` when intratool should render more than a normal link. Select one of the supported [URL Context Display Types](#url-context-display-types); the target URL must resolve through [URL Context](/introduction/resource-capabilities/url-context.md).
**URL Context Display Types**
* `inline` - Renders the resolved context within the surrounding text flow.
* `card` - Renders the resolved context as a standalone card.
* `embedded` - Embeds the resolved context in the rich-text content.
```html
Safety instructionsSafety instructions
```
Use a [SharedItem](/api-reference/shared-items.md) when the linked resource needs a stable share URL. Create the Shared Item for the target resource and store the returned `static_url`; do not construct grant-token URLs or copy temporary access URLs into rich text.
## Files and Media
Use URLs returned for [FilemanagerFiles](/api-reference/filemanager/filemanager-files.md), or the `static_url` returned for a `SharedItem` when the file must be shared through rich text. Do not store filesystem paths, storage keys, or base64 data as persistent file references.
Use an anchor for a downloadable or previewable file, `` for an image, and a `` child for audio or video.
```html
```
Images can select one supported [Image Size Class](#image-size-classes) and can additionally select one [Image Float Class](#image-float-classes).
**Image Size Classes**
* `image-fullwidth` - Uses the full available width.
* `image-three-quarters` - Uses three quarters of the available width.
* `image-two-thirds` - Uses two thirds of the available width.
* `image-half` - Uses half of the available width.
* `image-one-third` - Uses one third of the available width.
* `image-one-quarter` - Uses one quarter of the available width.
**Image Float Classes**
* `float-left` - Floats the image to the left of surrounding content.
* `float-right` - Floats the image to the right of surrounding content.
```html
```
The file URL must return the actual media content when used in `src`. Use the file-content or playback URL supplied by the API; a Filemanager page URL or a Shared Item landing-page URL is not a media source by itself.
For a Shared Item media source, append exactly one supported [Media Target URL Parameter](#media-target-url-parameters).
**Media Target URL Parameters**
* `showFileContent=1` - Returns image content.
* `downloadFileContent=1` - Returns audio or video content.
* `filePoster=1` - Returns a video poster.
## Tables
Use standard table markup with `
` for header cells and `
` for data cells. Wrap the content of every cell in a paragraph.
```html
Item
Status
Emergency stop
Checked
```
Merged cells can use `colspan` and `rowspan`. Preserve an existing `colwidth` attribute when round-tripping editor-generated column widths, but do not add viewer-only responsive wrappers to the stored HTML.
## Dynamic Content
Fields that support [System Variables](/introduction/system-variables.md) can place a variable inside ordinary rich-text nodes. Keep the complete variable expression together instead of splitting it across formatting tags.
```html
Hello {{ system.user.first_name }}, your task is ready.
```
## Unsupported Markup
Send only the documented elements and attributes. Scripts, event-handler attributes, iframes, arbitrary CSS, and application-rendering wrappers are outside the rich-text contract, and a later edit in TipTap can normalize or remove unsupported markup.