Working with Blocks

Notebooks are based on Blocks and these Blocks can come in lots of different forms.

They can contain both Rich Text and Media as well as serve your actual analysis in the form of Parameters, Charts and Queries.

In this part of the Documentation, you are gonna get an overview of how to use Blocks including how to ...

as well as even more advanced capabilities like duplication, and embedding.

1 - Create & Delete

1.1 - Create

There are two ways to create a new Block. You can either:

  • Use the +  Menu for it, or
  • Make use of its short-cut  (which you can look up in the  + Menu)

Using the + Menu

To enter the  +  Menu, either use its shortcut Ctrl + Dot when in a line/block or click on the + button at the left of it.

You can use the search bar to filter for the block type that you want to create or just scroll through all available types.


As a quicker alternative to the + Menu, you can also use shortcuts to create blocks.

All text Blocks follow Markdown syntax and can be created just as if you were writing a Google Doc or Notion page (press for a new row and you are ready to go).

You can find all the shortcuts next to respective block names in the + Menu.  

Get an overview over the different types of blocks and create them via the + Button

1.2 - Delete

To delete a Block, enter its context menu via the :: button and click on  Delete.


2 - Text Blocks & Inline Styling

To make your reports more appealing and easy to read, you can utilize a number of different text block types and various inline styles in

2.1- Text Blocks

Apart from plain text, you can add Headings, Bulleted/Numbered Lists, Blockquotes & Codeblocks , and Divider Lines to your notebooks.

You can create them either by clicking on the  + button or using their respective shortcuts (MD syntax).

2.2 - Inline-Styles

To style a specific part of your text, simply select it and choose one of the available formatting options from the toolbar.

Use inline-styles to make your text more interesting

Links can be a useful tool to reference external sources or other notebooks.

Create links

There are two ways to add links: You can either (1) add a link via the 🔗-icon in the toolbar when some text is selected, or (2) copy a URL to your clipboard and paste it directly while a range of text is selected.

Add links via the text toolbar or by copy & pasting them when some text is selected

3 - Media Blocks

Media Blocks like images or videos can add additional, easy-to-consume context to your notebooks.

3.1 - Images

You can embed images either ...

  1. via the + button (> Image), or
  2. by directly pasting an image/its link into your notebook (Gifs also work!)
Add an image either via the + menu or by pasting its link directly into the notebook

4 - Move, Drag 'n drop

Sometimes you'll want to rearrange the content of your notebook because that one layout actually just makes more sense overall or is easier to follow. This section is about how to do so.

4.1 - Drag 'n drop blocks

In, all Blocks are drag n' droppable.
This allows you to move them freely around the page and arrange and rearrange them however you like.

To drag a block, click and hold it's context menu button (::). Then move your cursor wherever you want to place the block and stop holding once you see a blue bar where you want to place the block.

Drag n' drop blocks using the context menu button

4.2 - Move Blocks to another page

To move a specific block to another page, go into its context menu (::) and hover over Move to. Select the page that you want to move it to or create a new one by clicking on the respective options.

5 - Commenting

Comments are a great way to collaborate directly in context.
You can use them to respond to and give feedback, tweak your reports, and iterate faster.

5.1 - Adding comments

In, comments are structured in threads.
This allows you to easily keep different conversations apart from each other.

Creating a thread

To create a new comment thread for a block, click on the Comment button in its context menu (::).
On the right side of the screen, you can now enter your comment. You are also able to see all the existing threads.

Create a new comment thread via the context menu

Creating a new thread

To reply to an existing thread, you can either

  1. use the above described way and reply from there or
  2. click on the 💬 icon on the right side of a block.

Both ways lead you into the comment view, where you can see and reply to all open threads as well as look at the already closed threads.

Reply to comments from others in the comments view

5.2 - Edit and delete comments

Want to correct that typo, add something you forgot or delete your comment overall?

In the comment view you can do all of these things by clicking on the  ... icon right of a comment.

Click on  Edit or  Delete to execute the respective option.

Edit or delete comments through the "more options" menu

5.3 - Resolving and reopening threads

After a conversation has come to an end, it makes sense to close its thread.
To do so, click on the Resolve button in the respective thread view. It will now appear in the Closed tab. If you want to reopen a resolved thread, click on Reopen button in there.

ℹ️  Comments from a closed thread will not count towards the open comments counter next to the 💬 icon.

6 - Further options

Apart from the above already mentioned options, the context menu (::) offers you some more possibilities on things that you can do with Blocks. These include duplication, linking to specific blocks, and block type conversion.

6.1 - Duplicate Blocks

You might run into situations where you want to duplicate a certain Chart, SQL Block, or part of text. To do so, go into a blocks context menu (::) and click Duplicate.

Duplicate blocks via the context menu

When working on a report or analysis, you will often come across scenarios where you want to discuss specific queries, charts, or parts of text with colleagues or other stakeholders.

To help your collaborators avoid the search for these specific blocks, you can generate links for all blocks in your notebook. To do so, go into the context menu (::) of the block and click Copy link. You can now share the URL of this block directly and the editor will jump to this part of your notebook automatically.

Get a link to a specific block of your notebook to share with your collaborators

6.3 - Block type conversion

To easily change the type of a block (blockquote to heading, inline-code to SQL etc.) into another one, the context menu (::) includes a turn into option. Select the type of block that you want to convert to and off you go!

Use "Turn into" in the context menu to easily change the type of a block.
Jump to