tiptap/docs/api/nodes/hard-break.md

description	icon
Sometimes we all need a break, even if it’s just a line break.	text-wrap

HardBreak

The HardBreak extensions adds support for the <br> HTML tag, which forces a line break.

Installation

# with npm
npm install @tiptap/extension-hard-break

# with Yarn
yarn add @tiptap/extension-hard-break

Settings

HTMLAttributes

Custom HTML attributes that should be added to the rendered HTML tag.

HardBreak.configure({
  HTMLAttributes: {
    class: 'my-custom-class',
  },
})

keepMarks

Decides whether to keep marks after a line break. Based on the keepOnSplit option for marks.

Default: true

HardBreak.configure({
  keepMarks: false,
})

Commands

setHardBreak()

Add a line break.

editor.commands.setHardBreak()

Keyboard shortcuts

Command	Windows/Linux	macOS
setHardBreak	Shift Enter Control Enter	Shift Enter Cmd Enter

Source code

packages/extension-hard-break/

Usage

https://embed.tiptap.dev/preview/Nodes/HardBreak