Last updated
Was this helpful?
Last updated
Was this helpful?
The inline palette lets you quickly add extra content to your text block without moving your hands away from the keyboard. Simply hit / on any text block to open the inline palette. The forward slash will be replaced by the content you choose to insert.
With annotations, you can add extra context to your words without breaking the reader’s train of thought. You can use them to explain the meaning of a word, insert extra information, and more. Readers can hover over the annotated text to show the annotation above the text.
To create an annotation, select the text you would like to annotate and click the Annotate option in the context menu. Once you’ve written your annotation, click outside of it to continue writing in the text block.
Inline images will sit alongside your text on the page.
By default, images are set to their original size with a maximum width of 300px. You can change the size by clicking the image to open the formatting palette, then choosing one of the three options:
Inline size: The image is proportionally sized to the font — great for icons and badges.
Original size: The image will remain inline at its original size, with a maximum width of 300 pixels.
You can add emojis by hitting / to open the inline palette. Alternatively, type : and a list of emojis will pop up directly in line — you can start typing the name of an emoji to narrow down the selection.
You can insert three different types of links:
Here’s how to insert a relative link:
Click somewhere in your paragraph where you want to insert the link, or select some text.
Hit / to open the inline palette and choose Link, click the Link button in the context menu, or hit ⌘ + K.
Start typing the title of the page you want to link to.
Select the page from the drop-down search results.
Hit Enter.
Absolute links are external links that you can copy and paste into your content. They’re great when you want to link to something outside your documentation.
To insert an absolute link:
Click somewhere in your paragraph where you want to insert the link, or select some text.
Hit / to open the inline palette and choose Link, click the Link button in the context menu, or hit ⌘ + K.
Paste the URL you want to link to.
Hit Enter.
Email address mailto links are useful when you want your visitors to click on a link that will open up their default email client and fill in the To field with the email address of your link, so they can write an email to send.
Here’s how to insert an email address mailto link:
Click somewhere in your paragraph where you want to insert the link, or select some text.
Hit / to open the inline palette and choose Link, click the Link button in the context menu, or hit ⌘ + K.
Paste or type mailto:something@address.com, replacing something@address.com with the email address you would like to use.
Hit Enter.
Buttons are a great way to describe calls to action. You can use them to send users to other pages in GitBook, or to external URLs.
Buttons have both primary and secondary styles. Here are a couple of examples:
You can write content as to add them as annotations in GitBook.
Convert to block: This turns an inline image into a , which is as wide as your content.
offer more options, including more sizes and the ability to add a caption — but will not appear inline with your text.
Relative links are links created by linking to that already exist in your space. The advantage of using relative links is that if the page’s URL, name, or location changes, its reference will be kept up to date — so you’ll end up with fewer broken links.
Using this option, you can create an inline math formula in your content, like this: . We use the library to render formulas.
You can also insert by opening the command palette in an empty block and choosing the second Math & TeX option.
Use the inline palette to add images, links, math & TeX, and more
