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.
Link to an anchor
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.
My heading 1
My heading 2
My heading 3
Representation in Markdown
# My heading 1
## My heading 2
### My heading 3