tiptap/docs/api/nodes/code-block-lowlight.md
2021-10-14 00:13:50 +02:00

2.1 KiB
Raw Blame History

description
Add some colorful syntax highlighting to your code blocks.

CodeBlockLowlight

Version Downloads

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) or ∼∼∼  (three tildes and a space) and a code block is instantly added for you. You can even specify the language, try writing ```css . That should add a language-css class to the <code>-tag.

Installation

# with npm
npm install @tiptap/extension-code-block-lowlight

# with Yarn
yarn add @tiptap/extension-code-block-lowlight

Settings

HTMLAttributes

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

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

languageClassPrefix

Adds a prefix to language classes that are applied to code tags.

Default: 'language-'

CodeBlockLowlight.configure({
  languageClassPrefix: 'language-',
})

Commands

setCodeBlock()

Wrap content in a code block.

editor.commands.setCodeBlock()

toggleCodeBlock()

Toggle the code block.

editor.commands.toggleCodeBlock()

Keyboard shortcuts

Command Windows/Linux macOS
toggleCodeBlock Control Alt C Cmd Alt C

Source code

packages/extension-code-block-lowlight/

Usage