How to add and edit blocks within your content — plus a full list of the standard blocks GitBook offers.

GitBook is a block-based editor, meaning you can add all 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.

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.

  • Code Blocks

  • Image blocks

  • Tables

  • Cards

  • API Blocks

  • Integration blocks

Example of a full-width table block


Project A


Project B


Project C


Learn more about

Last updated