blocks

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

Blocks

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.

You can open the insert palette using the + button to the left of your content, or by typing / on an empty block.

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 Blocks
• Image blocks
• Tables
• Cards
• API Blocks
• Integration blocks

Example of a full-width table block

Project	Owner	Completeness
Project A	Mike	4
Project B	Jack	3
Project C	Samantha	5

Learn more about

Paragraphs	1 (1).png	paragraph.md
Headings	2 (1).png	heading.md
Unordered Lists	3 (1).png	unordered-list.md
Ordered Lists	4 (1).png	ordered-list.md
Task Lists	5 (1).png	task-list.md
Hints	6 (1).png	hint.md
Quotes	7 (1).png	quote.md
Code Blocks	8 (1).png	code-block.md
Files	9 (1).png	insert-files.md
Images	10 (1).png	insert-images.md
Embedded URLs	11 (1).png	embed-a-url.md
Tables	12 (1).png	table.md
Cards	1 (1).png	cards.md
Tabs	2 (1).png	tabs.md
Expandable Sections	3 (1).png	expandable.md
Drawings	4 (1).png	drawing.md
Math & TeX	5 (1).png	math-and-tex.md
API Methods	6 (1).png	Broken link
OpenAPI Methods	7 (1).png	openapi.md
Page Links	8 (1).png	page-link.md