---
title: "Блок «Параграф» — базовый текстовый блок"
description: "Базовый текстовый блок: строчное форматирование, markdown-сокращения, цветовые пресеты и поле text, которое он хранит."
source: https://blokeditor.com/ru/docs/paragraph/
lastmod: 2026-09-07
---

Фреймворк JavaScript

Блочные инструменты Параграф

# Параграф: базовый текстовый блок

Текстовый блок по умолчанию. Поддерживает полноценное строчное форматирование (жирный, курсив, ссылки, цвет). Пустые параграфы верхнего уровня не попадают в сохраняемые данные, если не включён `preserveBlank`; пустые параграфы, вложенные в другой блок (выноска, переключатель, колонка, …), сохраняются всегда.

### Импорт

TypeScript

```
import { Paragraph } from '@bloklabs/core/tools';
```

### Конфигурация

| Опция | Тип | По умолчанию | Описание |
| --- | --- | --- | --- |
| `placeholder` | `string` | `"Write something or press / to select a tool" (localised)` | Плейсхолдер, который показывается, когда блок пуст и находится в фокусе. |
| `preserveBlank` | `boolean` | `false` | Если true, пустые блоки-параграфы остаются в сохраняемых данных. Исключение: документ из одного пустого блока инструмента по умолчанию всегда сохраняется как `blocks: []`, независимо от этой опции. |
| `styles.size` | `string` | `undefined` | Собственное значение CSS-свойства font-size (например, "18px", "1.25rem"). |
| `styles.lineHeight` | `string` | `undefined` | Собственное значение CSS-свойства line-height (например, "1.8", "28px"). |
| `styles.marginTop` | `string` | `undefined` | Собственное значение CSS-свойства margin-top (например, "12px", "0.75rem"). |
| `styles.marginBottom` | `string` | `undefined` | Собственное значение CSS-свойства margin-bottom. |

### Формат данных

TypeScript

```
interface ParagraphData {
  text: string;             // HTML string (may include <b>, <i>, <a>, <mark>)
  textColor?: string;       // Block colour preset, present when set
  backgroundColor?: string; // Block background colour preset, present when set
}
```

JSON

```
{
  "id": "abc123",
  "type": "paragraph",
  "data": {
    "text": "Hello <b>world</b>"
  }
}
```

### Пример использования

TypeScript

```
import { Blok } from '@bloklabs/core';
import { Paragraph } from '@bloklabs/core/tools';

const editor = new Blok({
  holder: 'editor',
  tools: {
    paragraph: {
      class: Paragraph,
      placeholder: 'Start writing…',
      preserveBlank: false,
    },
  },
});
```