# Vellum

> Blueprintr's own diagram editor, covering the canvas, the two layers and the drawing tools.

Vellum is Blueprintr's diagram editor and the default engine for any new
diagram. It runs inside the blueprint editor, as a standalone diagram, and as a
desktop app.

![blueprint:josh/drawing-in-vellum](https://blueprintr.io/embed/josh/drawing-in-vellum?exclude=cmtpw6i3w0003lduy20wilmv1&hideTabBar=1#h=640)

## Two layers

Every shape sits on one of two layers.

| Layer | For |
| --- | --- |
| **Blueprint** | The diagram itself. Shapes here can carry strata, be linked to, and be read by Continuum. |
| **Notes** | Working annotations. Stickies, questions, things to resolve. |

![The layer pills at the bottom left of the canvas: Notes, Both and Blueprint, with Both selected](/api/folium-assets/cmtozmo5h0001ykw4si3tkb4l/raw)

Press <kbd>W</kbd> to switch which layer you draw on. The pills at the bottom
left control which layers you can *see*, so you can hide the noise without
deleting it.

Press <kbd>Shift</kbd> <kbd>Cmd</kbd> <kbd>P</kbd> to promote a Notes item to
the Blueprint layer.

## Getting around

<kbd>Cmd</kbd> <kbd>K</kbd> searches every shape, icon and command.

<kbd>Cmd</kbd> <kbd>0</kbd> resets the view; <kbd>Cmd</kbd> <kbd>1</kbd> fits
everything to the viewport.

## Tools

![The Vellum toolbar: shape, connector, text, sticky, pen and icon tools, each labelled with its keyboard shortcut](/api/folium-assets/cmtozlgck00064yqzbj6v3zjs/raw)

| Key | Tool |
| --- | --- |
| <kbd>Q</kbd> | Tool lock, keeping a drawing tool active so you can drop several shapes in a row |
| <kbd>8</kbd> | Container, a frame you drag shapes into |
| <kbd>9</kbd> | Freehand pen, for annotating over the canvas |
| <kbd>L</kbd> | Laser pointer, a fading cursor trail for screen shares |

> [!TIP]
> The **Tips & shortcuts** button in the editor lists everything, always
> current. The [shortcuts page](/foliums/blueprintr-user-guide/vellum/keyboard-shortcuts)
> here mirrors it.

> [!TILES 3]
>
> === [Shapes and connectors](/foliums/blueprintr-user-guide/vellum/shapes-and-connectors)
>
> What you can draw, and how connectors attach.
>
> === [Icon packs](/foliums/blueprintr-user-guide/vellum/icon-packs-and-libraries)
>
> Thousands of vendor icons, plus your own.
>
> === [Other engines](/foliums/blueprintr-user-guide/vellum/draw-io-excalidraw-and-mermaid)
>
> draw.io, Excalidraw and Mermaid.
