Blocks
Add and edit blocks within your content.
Last updated
Was this helpful?
Add and edit blocks within your content.
Last updated
Was this helpful?
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.
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 Enter.
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.
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.
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
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:
