---
title: "HardBreak 扩展"
description: "在 Tiptap 中使用 Hard Break 扩展，以支持 `` HTML 标签进行换行。在我们的文档中了解更多信息！"
canonical_url: "https://tiptap.zhcndoc.com/editor/extensions/nodes/hard-break"
---

# HardBreak 扩展

在 Tiptap 中使用 Hard Break 扩展，以支持 `` HTML 标签进行换行。在我们的文档中了解更多信息！

HardBreak 扩展支持 `<br>` HTML 标签，这将强制换行。

> **Interactive demo:** [HardBreak](https://embed.tiptap.dev/preview/Nodes/HardBreak)

## 安装

```bash
npm install @tiptap/extension-hard-break
```

## 设置

### HTMLAttributes

应添加到渲染 HTML 标签的自定义 HTML 属性。

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

### keepMarks

决定在换行后是否保留标记。这基于标记的 `keepOnSplit` 选项。

默认值: `true`

```js
HardBreak.configure({
  keepMarks: false,
})
```

## 命令

### setHardBreak()

添加一个换行符。

```js
editor.commands.setHardBreak()
```

## 快捷键

| 命令           | Windows/Linux                   | macOS                       |
| ------------ | ------------------------------- | --------------------------- |
| setHardBreak | Shift + Enter + Control + Enter | Shift + Enter + Cmd + Enter |

## 源代码

[packages/extension-hard-break/](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-hard-break/)