How to use GitBook’s editor

Learn how to edit pages, insert blocks, and create content on a page using GitBook’s editor

GitBook’s editor makes it easy to create and customize documentation, whether you’re starting fresh or working in an existing space.

This video and guide will take you through GitBook’s native editor, covering:

1

Start a new change request

To edit published content, start by creating a new change request. This gives you a dedicated place to make and review edits, without pushing them live right away.

If you’re new to the workflow, start with change requests.

2

Set up your page

You can set the page title at the top. This is what readers see in the sidebar.

You can also add a page description and an icon/emoji.

3

Configure page options

Open Page options to control layout and presentation.

Use it to pick a layout (including templates like landing pages). You can also switch block width between default and full width.

If you need a cleaner view, hide the page title, description, sidebars, or footer. These overrides apply only to the current page.

4

Control page visibility

GitBook gives you fine-grained control over who can see content. You can hide a page from navigation but still share it via a direct link.

You can also control discoverability:

5

Edit content with blocks

You can start typing to add content at any time.

Type / to open the block insert menu, then search for what you need. Common blocks include tables, cards, expandables, tabs, and more.

If you prefer keyboard-first formatting, GitBook supports Markdown too.

6

Add integrations and advanced content

The insert menu also lets you pull in more powerful content:

  • Integrations installed in your space (GitHub files, forms, embeds)

  • Reusable content for shared snippets

  • OpenAPI specifications for interactive API docs

Last updated

Was this helpful?