Pages & Notes (Block Editor)

Pages is your built-in tool for notes, documentation, and knowledge management. The Notion-like block editor enables structured content with diverse formatting options.

Overview

The Pages feature consists of two areas:

Creating Pages

Create a New Page

1. Click + New Page in the page tree
2. Enter a title
3. Optionally select a parent page (for nested hierarchies)
4. Click Create

Page Types

The Page Tree

Navigation

• Pages are arranged hierarchically (parent and child pages)
• Click the arrow next to a page to expand/collapse child pages
• Click a page to open it in the editor

Searching Pages

1. Use the search field at the top of the page tree
2. Type the page name
3. Results are filtered live

Organizing Pages

• Move: Drag and drop pages in the page tree to adjust the hierarchy
• Nest: Drag a page onto another to make it a child page

Breadcrumb Navigation

Above the editor, a breadcrumb bar shows the path to the current page:

Home > Project Documentation > API Design > Endpoints

Click an entry to jump directly to that page.

The Block Editor

The editor is based on Tiptap and works with blocks. Each paragraph, heading, and element is a block.

Slash Commands (/ Menu)

Type / at the beginning of a line to open the block menu:

Type the first letters of the desired block to filter the selection, and confirm with Enter.

Bubble Menu (Text Formatting)

Select text to display the bubble menu:

Task Lists

Create interactive checklists:

1. Type /task and confirm with Enter
2. Write your task
3. Click the checkbox to check off tasks
4. Press Enter for the next task

Code Blocks

For source code with syntax highlighting:

1. Type /code and confirm with Enter
2. Select the programming language from the dropdown
3. Enter your code
4. Highlighting automatically adapts to the selected language

Callout Blocks

Callouts are highlighted information boxes:

1. Type /callout and confirm with Enter
2. Write your note text
3. Callouts are ideal for important notes, warnings, or tips

Auto-Save

The editor saves your changes automatically:

• Changes are saved after 500 milliseconds of inactivity
• A status indicator shows the save status:
  • Saved -- All changes are saved
  • Saving... -- Changes are being transmitted

Page Icons

Give your pages a visual identifier:

1. Click the icon to the left of the page title
2. Choose an emoji from the picker
3. The icon appears in the page tree and breadcrumb navigation

Keyboard Shortcuts

Tips for Effective Documentation

1. Use hierarchy -- Group related pages as child pages for clear structures
2. Assign icons -- Emojis as page icons make it easier to find pages quickly
3. Use task lists -- Ideal for meeting notes with action items
4. Use callouts -- Visually highlight important information
5. Use project pages -- Keep project-specific documentation directly with the project (Professional plan)
6. Use search -- With many pages, find content faster using the search in the page tree