Blocks

Add and edit blocks within your content

GitBook is a block-based editor, meaning you can add different kinds of blocks to your content — from standard text and images to interactive blocks. Your pages can include any combination of blocks you want, and there’s no limit to the number of blocks you can have on a page.

GitBook's built in content blocks.

Inserting a new content block

You can insert a new content block below an existing block using your mouse:

1. Hover over the block above the place you need the new content block.

2. Click on the + icon that appears on the left to open the insert palette.

3. Select the block you want from the drop-down menu to insert it.

Alternatively, on a new line, you can press / to launch the insert palette, which lists all the available blocks. You can scroll through the list to find the one you want, or use your keyboard to search for the block you want, navigate up and down the list, and insert it with Enter.

Exiting a block

Some content blocks capture the editing cursor to allow you to add content in the context of that block. For example, when you’re writing in a hint block, hitting Enter will add a new line within the hint block, rather than a new paragraph below.

When you are done, you can continue adding new content to the page either by inserting a new block using the + button to the left of your content, or by hitting ⌘ + Enter on a Mac or Ctrl + Enter on a PC.

Selecting blocks and interacting with selected blocks

You can select a single block by pressing the Esc key with the cursor in the block. You can also select multiple blocks by highlighting content within them and hitting Esc.

Once selected, you can:

• Select more blocks by clicking on them while keeping the Shift ⇧ key pressed.

• Moving up and down to select the block above or below, using the ↑ and ↓ keys

• Copy the entire block using ⌘ + C (Mac) or Ctrl + C (Windows)

• Cut the entire block using ⌘ + X (Mac) or Ctrl + X (Windows)

• Delete the selected block or blocks using ⌫ or Del.

Full-width blocks

By making your blocks full width, you can create a clear visual hierarchy in your content, or simply give more space to content that needs it.

To make a block full width, click on the Options menu next to your block and select Full width. This feature is available for the following block types:

• Code

• Images

• Tables

• Cards

• Columns

• Integration blocks

Some blocks will always display full-width, regardless of the page’s width setting in the the Page options menu:

• OpenAPI