tiptap/docs/api/nodes/code-block-lowlight.md
2021-10-18 18:01:47 +02:00

2.1 KiB
Raw Blame History

description icon
Add some colorful syntax highlighting to your code blocks. terminal-box-fill

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

https://embed.tiptap.dev/preview/Nodes/CodeBlockLowlight