Merge pull request #2861 from ueberdosis/bdbch/210-docs-update

docs(docs): add missing documentation for commands

docs/api/commands/create-paragraph-near.md

@@ -1,5 +1,7 @@
 # createParagraphNear
+If a block node is currently selected, the `createParagraphNear` command creates an empty paragraph after the currently selected block node. If the selected block node is the first child of its parent, the new paragraph will be inserted before the current selection.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.createParagraphNear()
+```

docs/api/commands/delete-node.md

@@ -1,5 +1,16 @@
 # deleteNode
+The `deleteNode` command deletes a node inside the current selection. It requires a `typeOrName` argument, which can be a string or a `NodeType` to find the node that needs to be deleted. After deleting the node, the view will automatically scroll to the cursors position.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | NodeType`
-:::
+
+## Usage
+```js
+// deletes a paragraph node
+editor.commands.deleteNode('paragraph')
+
+// or
+
+// deletes a custom node
+editor.commands.deleteNode(MyCustomNode)
+```

docs/api/commands/delete-range.md

@@ -1,5 +1,10 @@
 # deleteRange
+The `deleteRange` command deletes everything in a given range. It requires a `range` attribute of type `Range`.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`range: Range`
-:::
+
+## Usage
+```js
+editor.commands.deleteRange({ from: 0, to: 12 })
+```

docs/api/commands/delete-selection.md

@@ -1,5 +1,7 @@
 # deleteSelection
+The `deleteSelection` command deletes the currently selected nodes. If no selection exists, nothing will be deleted.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.deleteSelection()
+```

docs/api/commands/enter.md

@@ -1,5 +1,7 @@
 # enter
+The `enter` command triggers an enter programmatically.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.enter()
+```

docs/api/commands/exit-code.md

@@ -1,5 +1,7 @@
 # exitCode
+The `exitCode` command will create a default block after the current selection if the selection is a `code` element and move the cursor to the new block.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.exitCode()
+```

docs/api/commands/insert-content-at.md

@@ -1,5 +1,26 @@
 # insertContentAt
+The `insertContentAt` will insert a string of html or a node at a given position or range. If a range is given, the new content will replace the content in the given range with the new content.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`position: number | Range`
-:::
+
+The position or range the content will be inserted in.
+
+`value: Content`
+
+The content to be inserted. Can be a string of HTML or a node.
+
+`options: Record<string, any>`
+
+* updateSelection: controls if the selection should be moved to the newly inserted content.
+* parseOptions: Passed content is parsed by ProseMirror. To hook into the parsing, you can pass `parseOptions` which are then handled by [ProseMirror](https://prosemirror.net/docs/ref/#model.ParseOptions).
+
+## Usage
+```js
+editor.commands.insertContentAt(12, '<p>Hello world</p>', {
+  updateSelection: true,
+  parseOptions: {
+    preserveWhitespace: 'full',
+  }
+})
+```

docs/api/commands/join-backward.md

@@ -1,5 +1,7 @@
 # joinBackward
+The `joinBackward` command joins two nodes backwards from the current selection. If the selection is empty and at the start of a textblock, `joinBackward` will try to reduce the distance between that block and the block before it. [See also](https://prosemirror.net/docs/ref/#commands.joinBackward)
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.joinBackward()
+```

docs/api/commands/join-forward.md

@@ -1,7 +1,8 @@
 # joinForward
+The `joinForward` command joins two nodes forwards from the current selection. If the selection is empty and at the end of a textblock, `joinForward` will try to reduce the distance between that block and the block after it. [See also](https://prosemirror.net/docs/ref/#commands.joinForward)
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.joinForward()
+```
 
-https://prosemirror.net/docs/ref/#commands.joinForward

docs/api/commands/keyboard-shortcut.md

@@ -1,5 +1,12 @@
 # keyboardShortcut
+The `keyboardShortcut` command will try to trigger a ShortcutEvent with a given name.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`name: String`
-:::
+
+The name of the shortcut to trigger.
+
+## Usage
+```js
+editor.commands.keyboardShortcut('undo')
+```

docs/api/commands/lift-empty-block.md

@@ -1,5 +1,7 @@
 # liftEmptyBlock
+If the currently selected block is an empty textblock, lift it if possible. **Lifting** means, that the block will be moved to the parent of the block it is currently in.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.liftEmptyBlock()
+```

docs/api/commands/lift-list-item.md

@@ -1,5 +1,7 @@
 # liftListItem
+The `liftListItem` will try to lift the list item around the current selection up into a wrapping parent list.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.liftListItem()
+```

docs/api/commands/lift.md

@@ -1,5 +1,20 @@
 # lift
+The `lift` command lifts a given node up into it's parent node. **Lifting** means, that the block will be moved to the parent of the block it is currently in.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: String | NodeType`
-:::
+
+The node that should be lifted. If the node is not found in the current selection, ignore the command.
+
+`attributes: Record<string, any>`
+
+The attributes the node should have to be lifted. This is **optional**.
+
+## Usage
+```js
+// lift any headline
+editor.commands.lift('headline')
+
+// lift only h2
+editor.commands.lift('headline', { level: 2 })
+```

docs/api/commands/newline-in-code.md

@@ -1,5 +1,7 @@
 # newlineInCode
+`newlineInCode` inserts a new line in the current code block. If a selection is set, the selection will be replaced with a newline character.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.newlineInCode()
+```

docs/api/commands/reset-attributes.md

@@ -1,5 +1,17 @@
 # resetAttributes
+`resetAttributes` resets some of the nodes attributes back to it's default attributes.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | Node`
-:::
+
+The node that should be resetted. Can be a string or a Node.
+
+`attributes: string | string[]`
+
+A string or an array of strings that defines which attributes should be reset.
+
+## Usage
+```js
+// reset the style and class attributes on the currently selected paragraph nodes
+editor.commands.resetAttributes('paragraph', ['style', 'class'])
+```

docs/api/commands/scroll-into-view.md

@@ -1,5 +1,7 @@
 # scrollIntoView
+`scrollIntoView` scrolls the view to the current selection or cursor position.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.scrollIntoView()
+```

docs/api/commands/select-node-backward.md

@@ -1,5 +1,7 @@
 # selectNodeBackward
+If the selection is empty and at the start of a textblock, `selectNodeBackward` will select the node before the current textblock if possible.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.selectNodeBackward()
+```

docs/api/commands/select-node-forward.md

@@ -1,5 +1,7 @@
 # selectNodeForward
+If the selection is empty and at the end of a textblock, `selectNodeForward` will select the node after the current textblock if possible.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.selectNodeForward()
+```

docs/api/commands/select-parent-node.md

@@ -1,5 +1,7 @@
 # selectParentNode
+`selectParentNode` will try to get the parent node of the currently selected node and move the selection to that node.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.selectParentNode()
+```

docs/api/commands/select-textblock-end.md

@@ -1,5 +1,7 @@
 # selectTextblockEnd
+The `selectTextblockEnd` will move the cursor to the end of the current textblock if the block is a valid textblock.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.selectTextblockEnd()
+```

docs/api/commands/select-textblock-start.md

@@ -1,5 +1,7 @@
 # selectTextblockStart
+The `selectTextblockStart` will move the cursor to the start of the current textblock if the block is a valid textblock.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.selectTextblockStart()
+```

docs/api/commands/set-mark.md

@@ -1,5 +1,17 @@
 # setMark
+The `setMark` command will add a new mark at the current selection.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+
-:::
+`typeOrName: string | MarkType`
+
+The type of a mark to add. Can be a string or a MarkType.
+
+`attributes: Record<string, any>`
+
+The attributes that should be applied to the mark. **This is optional.**
+
+## Usage
+```js
+editor.commands.setMark("bold", { class: 'bold-tag' })
+```

docs/api/commands/set-node-selection.md

@@ -1,5 +1,12 @@
 # setNodeSelection
+`setNodeSelection` creates a new NodeSelection at a given position. A node selection is a selection that points to a single node. [See more](https://prosemirror.net/docs/ref/#state.NodeSelection)
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`position: number`
-:::
+
+The position the NodeSelection will be created at.
+
+## Usage
+```js
+editor.commands.setNodeSelection(10)
+```

docs/api/commands/set-node.md

@@ -1,5 +1,17 @@
 # setNode
+The `setNode` command will replace a given range with a given node. The range depends on the current selection. **Important**: Currently `setNode` only supports text block nodes.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+
-:::
+`typeOrName: string | NodeType`
+
+The type of the node that will replace the range. Can be a string or a NodeType.
+
+`attributes?: Record<string, any>`
+
+The attributes that should be applied to the node. **This is optional.**
+
+## Usage
+```js
+editor.commands.setNode("paragraph", { id: "paragraph-01" })
+```

docs/api/commands/sink-list-item.md

@@ -1,5 +1,7 @@
 # sinkListItem
+The `sinkListItem` will try to sink the list item around the current selection down into a wrapping child list.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.liftListItem()
+```

docs/api/commands/split-block.md

@@ -1,5 +1,16 @@
 # splitBlock
+`splitBlock` will split the current node into two nodes at the current [NodeSelection](https://prosemirror.net/docs/ref/#state.NodeSelection). If the current selection is not splittable, the command will be ignored.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`options: Record<string, any>`
-:::
+
+* `keepMarks: boolean` - Defines if the marks should be kept or removed. Defaults to `true`.
+
+## Usage
+```js
+// split the current node and keep marks
+editor.commands.splitBlock()
+
+// split the current node and don't keep marks
+editor.commands.splitBlock({ keepMarks: false })
+```

docs/api/commands/split-list-item.md

@@ -1,5 +1,12 @@
 # splitListItem
+`splitListItem` splits one list item into two separate list items. If this is a nested list, the wrapping list item should be split.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | NodeType`
-:::
+
+The type of node that should be split into two separate list items.
+
+## Usage
+```js
+editor.commands.splitListItem('bullet_list')
+```

docs/api/commands/toggle-list.md

@@ -1,5 +1,20 @@
 # toggleList
+`toggleList` will toggle between different types of lists.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`listTypeOrName: string | NodeType`
-:::
+
+The type of node that should be used for the wrapping list
+
+`itemTypeOrName: string | NodeType`
+
+The type of node that should be used for the list items
+
+## Usage
+```js
+// toggle a bullet list with list items
+editor.commands.toggleList('bullet_list', 'list_item')
+
+// toggle a numbered list with list items
+editor.commands.toggleList('ordered_list', 'list_item')
+```

docs/api/commands/toggle-mark.md

@@ -1,5 +1,26 @@
 # toggleMark
+The `toggleMark` command toggles a specific mark on and off at the current selection.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | MarkType`
-:::
+
+The type of mark that should be toggled.
+
+`attributes?: Record<string, any>`
+
+The attributes that should be applied to the mark. **This is optional.**
+
+`options?: Record<string, any>`
+* `extendEmptyMarkRange: boolean` - Removes the mark even across the current selection. Defaults to `false`
+
+## Usage
+```js
+// toggles a bold mark
+editor.commands.toggleMark('bold')
+
+// toggles bold mark with a color attribute
+editor.commands.toggleMark('bold', { color: 'red' })
+
+// toggles a bold mark with a color attribute and removes the mark across the current selection
+editor.commands.toggleMark('bold', { color: 'red' }, { extendEmptyMarkRange: true })
+```

docs/api/commands/toggle-node.md

@@ -1,5 +1,24 @@
 # toggleNode
+`toggleNode` will a node with another node.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | NodeType`
-:::
+
+The type of node that should be toggled.
+
+`toggleTypeOrName: string | NodeType`
+
+The type of node that should be used for the toggling.
+
+`attributes?: Record<string, any>`
+
+The attributes that should be applied to the node. **This is optional.**
+
+## Usage
+```js
+// toggle a paragraph with a heading node
+editor.commands.toggleNode('paragraph', 'heading', { level: 1 })
+
+// toggle a paragraph with a image node
+editor.commands.toggleNode('paragraph', 'image', { src: 'https://example.com/image.png' })
+```

docs/api/commands/toggle-wrap.md

@@ -1,5 +1,17 @@
 # toggleWrap
+`toggleWrap` wraps the current node with a new node or removes a wrapping node.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | NodeType`
-:::
+
+The type of node that should be used for the wrapping node.
+
+`attributes?: Record<string, any>`
+
+The attributes that should be applied to the node. **This is optional.**
+
+## Usage
+```js
+// toggle wrap the current selection with a heading node
+editor.commands.toggleWrap('heading', { level: 1 })
+```

docs/api/commands/undo-input-rule.md

@@ -1,5 +1,7 @@
 # undoInputRule
+`undoInputRule` will undo the most recent input rule that was triggered.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.undoInputRule()
+```

docs/api/commands/unset-all-marks.md

@@ -1,5 +1,7 @@
 # unsetAllMarks
+`unsetAllMarks` will remove all marks from the current selection.
 
-:::warning
+## Usage
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+```js
-:::
+editor.commands.unsetAllMarks()
+```

docs/api/commands/unset-mark.md

@@ -1,5 +1,20 @@
 # unsetMark
+`unsetMark` will remove the mark from the current selection. Can also remove all marks across the current selection.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | MarkType`
-:::
+
+The type of mark that should be removed.
+
+`options?: Record<string, any>`
+
+* `extendEmptyMarkRange?: boolean` - Removes the mark even across the current selection. Defaults to `false`
+
+## Usage
+```js
+// removes a bold mark
+editor.commands.unsetMark('bold')
+
+// removes a bold mark across the current selection
+editor.commands.unsetMark('bold', { extendEmptyMarkRange: true })
+```

docs/api/commands/wrap-in-list.md

@@ -1,5 +1,17 @@
 # wrapInList
+`wrapInList` will wrap a node in the current selection in a list.
 
-:::warning
+## Parameters
-Oops, we didn’t find time to fill this page. Writing documentation needs attention to detail, a great understanding of the project and time to write. Though Tiptap is used by thousands of developers all around the world, it’s still a side project for us. Let’s change that and make open source our full-time job! [Become a sponsor!](https://github.com/sponsors/ueberdosis)
+`typeOrName: string | NodeType`
-:::
+
+The type of node that should be wrapped in a list.
+
+`attributes?: Record<string, any>`
+
+The attributes that should be applied to the list. **This is optional.**
+
+## Usage
+```js
+// wrap a paragraph in a bullet list
+editor.commands.wrapInList('paragraph')
+```

docs/links.yaml

@@ -158,22 +158,16 @@
           link: /api/commands/clear-nodes
         - title: createParagraphNear
           link: /api/commands/create-paragraph-near
-          type: draft
         - title: deleteNode
           link: /api/commands/delete-node
-          type: draft
         - title: deleteRange
           link: /api/commands/delete-range
-          type: draft
         - title: deleteSelection
           link: /api/commands/delete-selection
-          type: draft
         - title: enter
           link: /api/commands/enter
-          type: draft
         - title: exitCode
           link: /api/commands/exit-code
-          type: draft
         - title: extendMarkRange
           link: /api/commands/extend-mark-range
         - title: focus
@@ -184,101 +178,72 @@
           link: /api/commands/insert-content
         - title: insertContentAt
           link: /api/commands/insert-content-at
-          type: draft
         - title: joinBackward
           link: /api/commands/join-backward
-          type: draft
         - title: joinForward
           link: /api/commands/join-forward
-          type: draft
         - title: keyboardShortcut
           link: /api/commands/keyboard-shortcut
-          type: draft
         - title: liftEmptyBlock
           link: /api/commands/lift-empty-block
-          type: draft
         - title: liftListItem
           link: /api/commands/lift-list-item
-          type: draft
         - title: lift
           link: /api/commands/lift
-          type: draft
         - title: newlineInCode
           link: /api/commands/newline-in-code
-          type: draft
         - title: resetAttributes
           link: /api/commands/reset-attributes
-          type: draft
         - title: scrollIntoView
           link: /api/commands/scroll-into-view
-          type: draft
         - title: selectAll
           link: /api/commands/select-all
         - title: selectNodeBackward
           link: /api/commands/select-node-backward
-          type: draft
         - title: selectNodeForward
           link: /api/commands/select-node-forward
-          type: draft
         - title: selectParentNode
           link: /api/commands/select-parent-node
-          type: draft
         - title: selectTextblockEnd
           link: /api/commands/select-textblock-end
-          type: draft
         - title: selectTextblockStart
           link: /api/commands/select-textblock-start
-          type: draft
         - title: setContent
           link: /api/commands/set-content
         - title: setMark
           link: /api/commands/set-mark
-          type: draft
         - title: setMeta
           link: /api/commands/set-meta
         - title: setNode
           link: /api/commands/set-node
-          type: draft
         - title: setNodeSelection
           link: /api/commands/set-node-selection
-          type: draft
         - title: setTextSelection
           link: /api/commands/set-text-selection
         - title: sinkListItem
           link: /api/commands/sink-list-item
-          type: draft
         - title: splitBlock
           link: /api/commands/split-block
-          type: draft
         - title: splitListItem
           link: /api/commands/split-list-item
-          type: draft
         - title: toggleList
           link: /api/commands/toggle-list
-          type: draft
         - title: toggleMark
           link: /api/commands/toggle-mark
-          type: draft
         - title: toggleNode
           link: /api/commands/toggle-node
-          type: draft
         - title: toggleWrap
           link: /api/commands/toggle-wrap
-          type: draft
         - title: undoInputRule
           link: /api/commands/undo-input-rule
-          type: draft
         - title: unsetAllMarks
           link: /api/commands/unset-all-marks
-          type: draft
         - title: unsetMark
           link: /api/commands/unset-mark
-          type: draft
         - title: updateAttributes
           link: /api/commands/update-attributes
         - title: wrapInList
           link: /api/commands/wrap-in-list
-          type: draft
     - title: Nodes
       link: /api/nodes
       items: