tiptap/docs/src/docPages/api/extensions/code-block.md

28 lines
1.0 KiB
Markdown
Raw Normal View History

2020-08-19 03:39:41 +08:00
# CodeBlock
2020-09-10 23:29:34 +08:00
With the CodeBlock extension you can add fenced code blocks to your documents. Itll wrap the code in `<pre>` and `<code>` HTML tags.
Type three backticks and a space (`\`` ) and a code block is instantly added for you.
::: warning Restrictions
The CodeBlock extension doesnt come with styling and has no syntax highlighting built-in. Its on our roadmap though.
:::
2020-08-20 21:44:08 +08:00
## Options
| Option | Type | Default | Description |
| ------ | ------ | ------- | -------------------------------------------- |
| class | string | | Add a custom class to the rendered HTML tag. |
2020-08-20 21:44:08 +08:00
## Commands
| Command | Options | Description |
| --------- | ------- | ----------------------------- |
| codeBlock | — | Wrap content in a code block. |
2020-08-20 21:44:08 +08:00
## Keyboard shortcuts
* `Shift` + `Control` + `\`
## Source Code
[packages/extension-code-block/](https://github.com/ueberdosis/tiptap-next/blob/main/packages/extension-code-block/)
## Usage
<demo name="Extensions/CodeBlock" highlight="3-5,17,36" />