15 July: Variables, redesigned search, better diff view and more
Create and add reusable variables to your docs, plus a redesigned search experience for your published docs, and other editor improvements
Last updated
Was this helpful?
Create and add reusable variables to your docs, plus a redesigned search experience for your published docs, and other editor improvements
Last updated
Was this helpful?
Was this helpful?
With this release we’re introducing variables.
If you repeat the same name, phrase or version number multiple times within your content, you can create a to help keep all those instances in sync and accurate — which is useful if you ever need to update them, or they’re complex and often mistyped.
You can create variables scoped to a specific page or a specific space, and then use them as many times as you like within a space by adding
For example, you might want to add variables such as:
product_name
version_number
email_support
account_type
By using variables like these, you could easily update a product name or version number across your entire docs, simply by updating the variable itself.
To view, add and edit your variables, click the Variables icon in the header bar within a change request.
You can then use a variable to your content by adding an expression. Hit / and choose Expression from the list, then double-click the expression to open up the expression editor where you can choose the variable you want to add.
Variables are super useful on their own, but become even more powerful when paired with . We’ll talk about this combination more in the coming weeks.
We’ve improved the search experience for published sites, with the Ask or search… bar now holding the search experience in one place, without overlapping all of your content.
Before, the search panel would sit centrally over all of your page content, blocking users from seeing it while they searched.
Now, users type directly into the search bar — which holds both the standard keyword search and the GitBook AI search experiences.
Diff view helps you and other reviewers see what’s been edited within a change request. And now it also shows when a page’s title or description has changed!
We’ve improved the breadcrumbs in the editor to make it easier for you to quickly access site settings directly from a space.
When you’re editing a published space, you can click the icon of your site in the top-left of the editor to open a new site menu.
Here, you can instantly access your main site overview, insights, customization and settings. You can also visit the site or copy the site’s URL, saving you time clicking into different parts of the GitBook app.
Not only does this make it easier to jump to important areas right from your content — it also saves space in the header — and we think it looks great, too.
We’re constantly working to improve the way you and your team work in GitBook, and value your input on features, bugs, and more. Make sure you head to our official GitBook community to join the discussion.
