Creating Documentation

Knapsack uses Content Blocks (or just “Blocks”) to manage content in various areas of your documentation site. Blocks can be added to Pages and Pattern Pages on a content tab or at the bottom of a template tab.

When viewing a blank page, you’ll see a select menu that allows you to choose a content block to add.

Each block allows you to add a different form of content. The Text block is the most commonly used. Each block type may have slightly different ways of interacting with it. 

For example, click into the Text block to begin typing markdown text (markdown allows you to write text and add formatting with special syntax, see this cheat sheet to get started).

When hovering over a block, you’ll see a series of controls associated with it.

The right controls allow you to edit the block settings, move up or down or drag and drop the block amongst other blocks on the page, or delete the block. The plus button at the top middle of the block allow you to add a block directly above the hovered block. Hover over the bottom middle of the block and click the plus sign to add a block below. 

When multiple blocks are on a page, a drag handle allows you to drag and drop to reorder them. 

< Previous: Organizing the Library                 Next: Embedding Resources >