Create a distinction between the page name and name of the page in the table of contents on the left

[TheSevenPens]

Today a page's title shows up in the table of contents on the left. This is a good and reasonable default behavior.

The problem is that while I love having more descriptive titles for a page, because the full title is used in the TOC on the left, it creates for some rather large bulky entries.

Example:

What would be better is to allow me to select a shorter piece of text for that document to be used in the TOC. This would allow the TOC to look nicer, avoid repetition of common title elements, and be easier to navigate while still providing users with the ability to have long descriptive titles.

This is how for example, the documentation for Microsoft works. See the example below. The page title is "What is Azure Synapse Data Explorer? (Preview)". That page in the TOC appears as "Data Explorer Overview"

[lukejfuller]

This would be very helpful, I've found this limitation frustrating.

[clairechabas]

This is now available :)

Yu can now set a "link title" for a page which will be used for the page's table of contents entry and all other relative links (page footer navigation, page cards, mentions...).

This lets you set a different more descriptive title for the page itself (which will remain the title used for the page automatically computed URL segment as well).

See our updated docs here.

[TheSevenPens]

@clairechabas Thanks so much to the GitBook team for delivering this. It has a big impact for me - making my TOC easy-to-navigate and attractive.