Technically, blocks are a property of an entity. In pages, blocks make up the body of your content. In media entities such as images, web links, tweets, or files, the blocks property is labeled with
NOTES, as the main content can be regarded as the media item itself. In custom content types, one or several blocks properties can be added and named whatever you want.
Why blocks are useful
Blocks are a super flexibel way of authoring content. You can rearrange them, create hierarchies by nesting them, hide content using toggles, or make use of multi-column laoyuts.
Types of blocks
There are different types of blocks. Here is the list of blocks Capacities currently offers.
Text blocks are all blocks that let you write and format rich text. Capacities lets you build just the text block you need by letting you combine different interfaces:
Hierarchy interface: Lets you choose between
Heading 3, and
Toggle interface: If active, the block can be toggled.
List interface: If active, the block will be rendered as a list item with options for
Quote interface: If active, the text block will be rendered as a quote with a bar at the left side.
Emoji interface: If active, an emoji will appear in front of the block. If you click on it, the emoji picker opens and you can select any emoji you want.
To-do interface: If active, a to-do checkbox will be rendered in front of the text.
The code block allows you to add code snippets to your notes and edit them with a nice code editor. You can select from a wide variety of popular programming languages for syntax highlighting. The code block allows you to quickly copy the snippet to your clipboard or download it as a file.
The math block lets you add mathematical formulae to your notes using TeX syntax. You can find a full reference of all available functions here.
Layout blocks help you create beautiful content with a structure that makes sense.
The multi-column block lets you to arrange blocks in multi-column layouts. Just drag blocks next to each other to put them in a column to the left or the right.
The style options of this block offer a setting for
- the layout width (
Full) to make the multi-column block wider than the main content,
- the column layout (
Grid). Setting it to
Gridwill make items in the same row also have the same height, and
- styles to change the text or background color of the whole block.
The group block can be used to put several other blocks inside a box sets them apart with settings for
- the layout width (
Full) to make the group block wider than the main content and
- styles to change the text or background color of the group block.
Horizontal line block
This block is just a simple horizontal line that you can use to separate different sections.
If you add an image as a block, that's an entity block of type image. 🌄
You can create an entity block by creating any new entity (for example using the control dropdown with the
/ command or pasting a file from the clipboard) or by reusing an entity with the
@ command and then searching for it in the control dropdown.
An entity block supports different views. Entities can be displayed as a inline (icon and title), as a small card, as a wide card, or an embed. An embed lets you edit the embedded content in-place (a concept called transclusion). The design of the views may vary depending of the type of the content. Some basic content types also offer additional views. Images for examples can be additionally displayed as a small or large square or in full-width mode.
🤔 Do you find this explanation unclear or feel like something is missing in the docs?
With your help we can make the docs better for everyone. So just let us know, and we’ll improve it ASAP!
📨 Did reading the docs make you think of any product improvements?
Please let us know if you have an idea for a feature, think that something is missing or see a conceptual inconsistency that could be fixed. Just post it on our feedback board and discuss it with us and other users!