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:
Creating change requests to edit content
Configuring page options and layouts
Changing a page’s visibility and indexing settings
Syncing edits with Git Sync
and more!
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.
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.
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.
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:
Include or exclude the page from search indexing.
Allow or block web crawling (for tools like Google or ChatGPT).
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.
Related documentation
Last updated
Was this helpful?