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:
Hover over the block above the place you need the new content block.
Click on the
+icon that appears on the left to open the insert palette.
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
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
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.
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.
Example of a full-width table block
Learn more about