Add heading blocks to a page to organize your content and improve SEO.

Headings help give your documents structure — and using keywords in headings will also help search engines understand that structure, which can help your page rank higher in search results.

GitBook offers three levels of headings. Heading levels 1 (H1) and 2 (H2) will appear in the page outline.

Reading on a screen is less comfortable than reading on paper. Sometimes splitting longer content into different pages can help with overall readability.

When you add a heading to a page, it creates an anchor link. You can then link directly to these specific sections, to point people to relevant information.

You can see anchor links in public content, or private content in read-only mode, by hovering over the title and clicking the # that appears next to it. This will update the URL in your browser’s top bar, so you can copy it to use elsewhere.

If you want to link to a particular anchor from a page within your GitBook space, you can use a relative link, which will update if you change the heading to prevent the link from breaking.

Edit an anchor

By default, the anchor link will be identical to the text in your header. If you plan to link to that URL outside of GitBook, changing the header in future will break the anchor link. The link will then take visitors to the top of the page, rather than the anchor location.

To avoid this, you can manually set the anchor link by opening the Options menu for the header, then choosing Edit anchor. You can then enter the anchor link you wish to use — this will remain the anchor even if you change the header itself.

Heading examples

My heading 1

My heading 2

My heading 3

Representation in Markdown

# My heading 1
## My heading 2
### My heading 3

Last updated