---
title: "StarterKit 扩展"
description: "所有热门扩展集成于一个 StarterKit 扩展中。非常适合初学者使用 Tiptap。更多内容请参阅文档！"
canonical_url: "https://tiptap.zhcndoc.com/editor/extensions/functionality/starterkit"
---

# StarterKit 扩展

所有热门扩展集成于一个 StarterKit 扩展中。非常适合初学者使用 Tiptap。更多内容请参阅文档！

`StarterKit` 是一个集合了最受欢迎的 Tiptap 扩展的工具。如果你刚开始，这个扩展非常适合你。

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

## 安装

```bash
npm install @tiptap/starter-kit
```

## 包含的扩展

### 节点

- [`Blockquote`](https://tiptap.zhcndoc.com/editor/extensions/nodes/blockquote.md)
- [`BulletList`](https://tiptap.zhcndoc.com/editor/extensions/nodes/bullet-list.md)
- [`CodeBlock`](https://tiptap.zhcndoc.com/editor/extensions/nodes/code-block.md)
- [`Document`](https://tiptap.zhcndoc.com/editor/extensions/nodes/document.md)
- [`HardBreak`](https://tiptap.zhcndoc.com/editor/extensions/nodes/hard-break.md)
- [`Heading`](https://tiptap.zhcndoc.com/editor/extensions/nodes/heading.md)
- [`HorizontalRule`](https://tiptap.zhcndoc.com/editor/extensions/nodes/horizontal-rule.md)
- [`ListItem`](https://tiptap.zhcndoc.com/editor/extensions/nodes/list-item.md)
- [`OrderedList`](https://tiptap.zhcndoc.com/editor/extensions/nodes/ordered-list.md)
- [`Paragraph`](https://tiptap.zhcndoc.com/editor/extensions/nodes/paragraph.md)
- [`Text`](https://tiptap.zhcndoc.com/editor/extensions/nodes/text.md)

### 标记

- [`Bold`](https://tiptap.zhcndoc.com/editor/extensions/marks/bold.md)
- [`Code`](https://tiptap.zhcndoc.com/editor/extensions/marks/code.md)
- [`Italic`](https://tiptap.zhcndoc.com/editor/extensions/marks/italic.md)
- [`Link`](https://tiptap.zhcndoc.com/editor/extensions/marks/link.md) (v3 新增)
- [`Strike`](https://tiptap.zhcndoc.com/editor/extensions/marks/strike.md)
- [`Underline`](https://tiptap.zhcndoc.com/editor/extensions/marks/underline.md) (v3 新增)

### 扩展功能

- [`Dropcursor`](https://tiptap.zhcndoc.com/editor/extensions/functionality/dropcursor.md)
- [`Gapcursor`](https://tiptap.zhcndoc.com/editor/extensions/functionality/gapcursor.md)
- [`Undo/Redo`](https://tiptap.zhcndoc.com/editor/extensions/functionality/undo-redo.md)
- [`ListKeymap`](https://tiptap.zhcndoc.com/editor/extensions/functionality/listkeymap.md) (v3 新增)
- [`TrailingNode`](https://tiptap.zhcndoc.com/editor/extensions/functionality/trailing-node.md) (v3 新增)

## 源代码

[packages/starter-kit/](https://github.com/ueberdosis/tiptap/blob/main/packages/starter-kit/)

## 使用 StarterKit 扩展

将 `StarterKit` 传递给编辑器，以一次加载所有包含的扩展。

```js
import { Editor } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'

const editor = new Editor({
  content: '<p>示例文本</p>',
  extensions: [StarterKit],
})
```

你可以配置包含的扩展，甚至禁用其中的一些，如下所示。

```js
import { Editor } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'

const editor = new Editor({
  content: '<p>示例文本</p>',
  extensions: [
    StarterKit.configure({
      // 禁用一个包含的扩展
      undoRedo: false,

      // 配置一个包含的扩展
      heading: {
        levels: [1, 2],
      },
    }),
  ],
})
```

Tiptap 不允许存在两个具有相同 `name` 属性的扩展。如果自定义扩展与 StarterKit 中包含的某个扩展同名，请将其禁用：

```js
import { Editor, Mark } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'
import Link from '@tiptap/extension-link'

const CustomLinkExtension = Mark.create({
  name: 'link',
})

const editor = new Editor({
  extensions: [
    StarterKit.configure({
      // 禁用 Link 扩展
      // 以免它与 CustomLinkExtension 冲突
      link: false,
    }),
    CustomLinkExtension,
  ],
})
```