---
title: "Paragraph Block — Blok's Default Text Block"
description: "The default text block: inline formatting, markdown shortcuts, colour presets, and the text field it saves."
source: https://blokeditor.com/docs/paragraph/
lastmod: 2026-09-07
---

Framework JavaScript

Block Tools Paragraph

# Paragraph block: Blok's default text block

The default text block. Supports rich inline formatting (bold, italic, links, colour). Empty top-level paragraphs are excluded from saved output unless `preserveBlank` is enabled; empty paragraphs nested inside another block (callout, toggle, column, …) are always kept.

### Import

TypeScript

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

### Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `placeholder` | `string` | `"Write something or press / to select a tool" (localised)` | Placeholder text shown when the block is empty and focused. |
| `preserveBlank` | `boolean` | `false` | When true, empty paragraph blocks are kept in the saved output. Exception: a document consisting of a single empty block of the default tool always saves as `blocks: []`, regardless of this option. |
| `styles.size` | `string` | `undefined` | Custom CSS font-size override (e.g. "18px", "1.25rem"). |
| `styles.lineHeight` | `string` | `undefined` | Custom CSS line-height override (e.g. "1.8", "28px"). |
| `styles.marginTop` | `string` | `undefined` | Custom CSS margin-top override (e.g. "12px", "0.75rem"). |
| `styles.marginBottom` | `string` | `undefined` | Custom CSS margin-bottom override. |

### Save Data

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>"
  }
}
```

### Usage Example

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,
    },
  },
});
```