8 July: Custom code fonts, make your API spec public and more

You can now upload your own custom font for code blocks, create new sites more easily, make your API spec public and more

✨ New and noteworthy

Set a custom monospace font for code blocks

You’ve been able to upload a custom font for your docs for a while — but now you can do the same for a monospace font for code blocks and inline code.

To change your code font, head into your site’s Customization panel and select from the Monospace font dropdown menu.

Share your OpenAPI spec from your docs

You can now choose to generate a publicly-accessible URL for your OpenAPI specification once you’ve added it to GitBook — as long as your specification is marked as public. The URL will always point to the latest version of your specification.

With GitBook hosting your spec, it’s easy to use it both to instantly generate docs, and in external OpenAPI-based tools like Stainless, Postman or others.

Head into the OpenAPI section in the GitBook sidebar and find the API you want to make public — then simply hit the toggle.

Improved notification emails

Last month we improved a few of our emails with a better design and more context about the subject — and we mentioned we’d be doing the same to more emails soon.

Well, now we have! Our emails now all use this new improved style ✨

Simplified site creation flow

When you create a new site, you’ll now see a dashboard that’s more tailored to what you want to do.

First, you’ll see four large options at the top to offer you different ways to add content to your site — including Git Sync, OpenAPI spec upload, and import options.

Below that, you’ll also see four site templates to help you get started with an all-new site faster by adding content to an established structure.

Finally, you’ll see a list of all your existing content within GitBook, along with a search bar, allowing you to quickly add existing content to your site and publish with a click.

These changes should make it easier to create an publish your site fast 🏎️💨

Improved

• Table blocks and expandable blocks now support diff view more effectively. Before, editing any part of a table would show the entire table as being deleted and a new one created in diff view. The same went for changes in an expandable block. Now, the table or expandable shows as edited and the individual changes are highlighted within the block.

• We’ve added icons to diff view to make diffs accessible for color-blind users Make diff accessible to colour-blind users.

• You’ll now see a new option to visit the a published page’s live version in the Actions menu for individual page. This is especially useful for hidden pages that are otherwise difficult to access via URL.

• We no longer show captions on image and code blocks in the editor by default. Captions added a lot of white space in the editor, meaning big gaps between content if you didn’t want to add a caption. Now they won’t appear by default, but you can add one by hovering the image and clicking Caption in the menu that appears.

• You can now use keyboard shortcuts to insert new rows in tables. Hit Enter ⏎ to move down or Shift ⇧ + Enter ⏎ to move up between rows. Then hit Option ⌥ + Enter ⏎ to add a row below, or hit Shift ⇧ + Option ⌥ + Enter ⏎ to add a row above.

• You can now convert H1, H2 and H3 heading blocks to other heading styles by adding # at the beginning of a row.

• We’ve added a confirmation button to the annotation and Math popover when adding them inline. Your changes are saved automatically, but it helps reassure users that their changes are saved.

• We now check that uploading files are compatible with inserting into GitBook before you upload them to avoid wasted uploads.

• We’ve updated the Docs sites screen to make it easier to find and open your site.

Fixed

• Fixed an issue that meant the comments button in a change request would show the wrong count.

• Fixed an issue that meant removing the dark mode logo for a site would also remove the light mode version of the logo. Now it will only remove the dark mode logo as expected.

• Fixed a bug in the Layout section of the Customization menu that meant it was sometimes impossible to select certain spaces or pages to link to.

• Fixed an issue that was causing the Markdown formatting soft line breaks to be incorrectly parsed in Git Sync.

• Fixed a bug that made the code block toolbar editable.

• Restored the ability to reinstall integrations on every space after uninstalling on one or two spaces.

• Fixed a bug that caused emojis to be removed from table of contents when syncing from GitHub

• Fixed a bug that meant hidden pages were hidden from everyone in the GitBook app and could only be seen by those with editor permissions or above within change requests. Now, members with editor permissions and above will see hidden pages in the table of contents.

• Fixed an issue that meant hitting Shift + Enter would not insert a new line in a table cell.

• Fixed an issue that meant the number of commenters you could filter by in the Comments side panel was limited to 10. The new limit is 50.

• Fixed an issue that meant some images were being presented at a larger size than their original dimensions when clicked in GitBook. The images will now only appear at their original size at a maximum.

• Fixed a bug that caused images that you chose to ‘Quick look’ in the Images modal to appear behind the modal rather than in front of it.

---

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.