Blocks and Pages

Craft uses a unique block-based structure that makes organizing your work intuitive and flexible. Understanding how blocks, pages, and documents work together is fundamental to getting the most out of Craft.

​

What is a Block?

In Craft, everything you create is a block. Every paragraph, image, table, or heading is its own independent unit. This might seem simple, but it’s incredibly powerful. Each block can:

• Contain its own content (text, media, tables, etc.)
• Be styled independently
• Be moved, copied, or deleted on its own
• Transform into a page with deeper content

Think of blocks as LEGO pieces. You can arrange them however you want, and each one can serve multiple purposes.

​

From Blocks to Pages

Here’s where Craft gets interesting: any block can become a page. When a block contains nested content beneath it, it’s called a page. You can click on a page block to navigate inside it and see all its nested content. This creates a natural hierarchy:

• A block is a single unit of content
• A page is a block that contains other blocks inside it
• A document is the top-level container you see in your sidebar

​

Creating Structure with Page Styles

While any block with nested content is technically a page, Craft offers special visual styles to make pages stand out: Page Style: This text style is designed specifically for page blocks. It gives the block a distinct appearance that signals “there’s more inside.” Card Style: Cards provide an even more visual way to represent pages. They can include:

• Cover images
• Custom colors
• Rich previews

Both styles make it easy to scan your document and understand its structure at a glance.

​

Grouping Blocks into Pages

When you have several related blocks, you can group them into a page. This is perfect for organizing your thoughts as you write. Ungrouping: To reverse the process, select a page block and press Cmd+Shift+G (Mac) or use the “Ungroup” action. All nested blocks move back to the same level as the page.

​

Moving Blocks Between Documents

Because blocks are independent units, you can easily move them around – even between different documents.

​

Important Note About Pages vs Documents

Understanding the difference between pages and documents is crucial for organizing your work: Documents are top-level items that appear in your sidebar. They can be:

• Starred for quick access
• Organized into folders
• Moved to trash and recovered
• Shared or published independently

Pages are blocks within documents. They:

• Only exist inside a parent document
• Don’t appear separately in your sidebar
• Are treated as content within the document
• Can’t be starred or organized independently

​

Building Your Knowledge, One Block at a Time

The beauty of Craft’s block system is that it matches how you think. You don’t need to decide upfront whether something should be a separate document or a page within a document. Start writing. If a section needs more detail, turn it into a page. If a page grows too complex, you can always move those blocks into a new document. This flexibility means your structure can evolve naturally as your ideas develop. Just focus on capturing your thoughts – Craft makes it easy to organize them later.

​

Common Workflows

Building a Project Plan

1. Create a document called “Q1 Projects”
2. Write each project name as a block
3. Click into each project block to add details inside
4. Add tasks, notes, and files within each project page

Taking Meeting Notes

1. Start with agenda items as regular blocks
2. As discussion happens, add details beneath each item
3. The agenda items automatically become pages
4. Navigate in and out to see overview or details

Creating a Knowledge Base

1. Start with broad topics as blocks
2. Click into each topic to add subtopics
3. Each subtopic can become its own page
4. Build a hierarchy as deep as you need