> ## Documentation Index
> Fetch the complete documentation index at: https://react-docx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BreakLine

Line break within a paragraph (soft return).

```tsx theme={"dark"}
<Paragraph>
  First line
  <BreakLine />
  Second line
</Paragraph>
```

***

## Usage

Creates a new line without starting a new paragraph:

```tsx theme={"dark"}
<Paragraph>
  Acme Corporation<BreakLine />
  123 Main Street<BreakLine />
  New York, NY 10001
</Paragraph>
```

***

## BreakLine vs new Paragraph

```tsx theme={"dark"}
{/* Two paragraphs - more spacing */}
<Paragraph>First paragraph</Paragraph>
<Paragraph>Second paragraph</Paragraph>

{/* One paragraph with break - less spacing */}
<Paragraph>
  First line
  <BreakLine />
  Second line
</Paragraph>
```

Use `BreakLine` when content belongs together but needs separate lines.

***

## Common patterns

### Address block

```tsx theme={"dark"}
<Paragraph>
  John Smith<BreakLine />
  123 Main Street<BreakLine />
  Apt 4B<BreakLine />
  New York, NY 10001
</Paragraph>
```

### Signature

```tsx theme={"dark"}
<Paragraph className="mt-8">
  Sincerely,<BreakLine />
  <BreakLine />
  <BreakLine />
  John Smith<BreakLine />
  CEO
</Paragraph>
```

### Poetry / verse

```tsx theme={"dark"}
<Paragraph className="italic">
  Roses are red,<BreakLine />
  Violets are blue,<BreakLine />
  Sugar is sweet,<BreakLine />
  And so are you.
</Paragraph>
```

### Multi-line label

```tsx theme={"dark"}
<Td className="border p-2">
  <Text className="font-bold">Primary Contact:</Text><BreakLine />
  Jane Doe<BreakLine />
  jane@example.com
</Td>
```
