Keyboard shortcuts
Every keyboard shortcut in Penna, for Mac and for Windows and Linux.
Keys are shown Mac first. On Windows and Linux, use Ctrl wherever a Mac shortcut uses ⌘, and Alt for ⌥. Buttons that have a shortcut show it in their tooltip. Letter shortcuts follow the key's position, so they work with any keyboard layout.
Anywhere in the editor
These work while the app has focus, including while you type in a field, except where the table says otherwise.
| Action | Mac | Windows and Linux |
|---|---|---|
| Search diagrams, elements and commands | ⌘ K | Ctrl K |
| Go to a diagram | ⌘ P | Ctrl P |
| Go to an element | ⇧ ⌘ O | Shift Ctrl O |
| Show or hide the sidebar | ⌘ B | Ctrl B |
| Show or hide Flowmark | ⌘ \ | Ctrl \ |
| Show or hide the Problems panel | ⌘ J | Ctrl J |
| Open the assistant and focus its message box | ⌘ I | Ctrl I |
| Show or hide the assistant | ⌥ ⌘ B | Alt Ctrl B |
| Show or hide the Properties panel | ⌥ ⌘ P | Alt Ctrl P |
| Apply the change the assistant proposes | ⌘ ↵ | Ctrl Enter |
Download the .bpmn file | ⇧ ⌘ E | Shift Ctrl E |
| Undo, when you aren't typing in a field | ⌘ Z | Ctrl Z |
| Redo, when you aren't typing in a field | ⇧ ⌘ Z | Shift Ctrl Z |
| Close a panel that's open over your work | Esc | Esc |
⌘ S (Ctrl S) saves nothing, because every change saves on its own. It shows a reminder of that instead.
On a phone, the assistant shortcuts and undo and redo don't apply, because the app is view-only there.
In the search menu
| Action | Mac | Windows and Linux |
|---|---|---|
| Move through the results | ↑ ↓ | ↑ ↓ |
| Open or run the highlighted result | ↵ | Enter |
| Close | Esc | Esc |
On the canvas
These work while the canvas has focus. Click an empty part of the canvas first if you've been typing somewhere else.
| Action | Mac | Windows and Linux |
|---|---|---|
| Undo | ⌘ Z | Ctrl Z |
| Redo | ⇧ ⌘ Z or ⌘ Y | Shift Ctrl Z or Ctrl Y |
| Fit the diagram to the view | ⌘ 0 | Ctrl 0 |
| Zoom in | + or = | + or = |
| Zoom out | - | - |
| Select every step | ⌘ A | Ctrl A |
| Go to the next or previous step | → ← | → ← |
| Go to the branch above or below | ↑ ↓ | ↑ ↓ |
| Add a task, user task, decision, parallel split, timer wait or end event after the selected step | T U G P I E | T U G P I E |
| Open the add menu for the selected step | A | A |
| Connect the selected step to another | C | C |
| Change the selected step's type | R | R |
| Add a lane | L | L |
| Ask the assistant about the selection | ⌘ L | Ctrl L |
| Comment on the selection | M | M |
| Copy, cut or paste steps | ⌘ C, ⌘ X, ⌘ V | Ctrl C, Ctrl X, Ctrl V |
| Duplicate the selection | ⌘ D | Ctrl D |
| Rename the selected element | ↵ or F2 | Enter or F2 |
| Delete the selection | ⌫ or ⌦ | Backspace or Delete |
| Open the menu for the selection | ⇧ F10 | Shift F10 or the Menu key |
| Cancel a drag or placing, close a menu, or clear the selection | Esc | Esc |
While the assistant waits for you to apply a change, only the zoom keys work on the canvas. While Flowmark has a mistake, the canvas shows the last version that worked: you can select, copy and comment, but not edit.
With the mouse or trackpad
| Action | Mac | Windows and Linux |
|---|---|---|
| Add to or remove from the selection | ⇧ or ⌘ and click | Shift and click |
| Select an area | ⇧ and drag empty canvas | Shift and drag empty canvas |
| Rename an element | Double-click it | Double-click it |
| Add a step at a point | Double-click empty canvas | Double-click empty canvas |
| Add after a step, or connect it | Drag its + handle | Drag its + handle |
| Move a step into an arrow or a lane | Drag it there | Drag it there |
| Open the menu for what's under the pointer | Right-click, or long-press on a touch screen | Right-click, or long-press on a touch screen |
| Zoom | Pinch, or ⌘ and scroll | Pinch, or Ctrl and scroll |
| Pan | Scroll, or drag empty canvas | Scroll, or drag empty canvas |
On a sequence diagram's canvas
The general canvas keys above work the same: undo and redo, zoom, select all, ask, comment, rename, delete and the menu. These are different on a sequence diagram:
| Action | Mac | Windows and Linux |
|---|---|---|
| Add a participant, actor or database | P A D | P A D |
| Add a message or a note after the selection | S N | S N |
| Add a reply to the selected message | R | R |
| Wrap the selected messages in a fragment | F | F |
| Go to the element above or below | ↑ ↓ | ↑ ↓ |
| Go to the participant to the left or right | ← → | ← → |
| Move the selection up, down, left or right | ⌥ and an arrow key | Alt and an arrow key |
In the Wrap in menu that F opens, each fragment has its own letter: A alt, O opt, L loop, P par, B break, C critical and G group.
While renaming
This applies to renaming on the canvas and to the diagram's name at the top left.
| Action | Mac | Windows and Linux |
|---|---|---|
| Save the name | ↵ | Enter |
| Cancel | Esc | Esc |
In the assistant's message box
| Action | Mac | Windows and Linux |
|---|---|---|
| Send, or queue a message while the assistant works | ↵ | Enter |
| New line | ⇧ ↵ | Shift Enter |
| Stop the assistant while it works | Esc | Esc |
| Remove the last element chip, in an empty box | ⌫ | Backspace |
When the @ or / list is open:
| Action | Mac | Windows and Linux |
|---|---|---|
| Move through the list | ↑ ↓ | ↑ ↓ |
| Pick the highlighted item | ↵ or ⇥ | Enter or Tab |
| Close the list | Esc | Esc |
In the Flowmark pane
The Flowmark pane is a text editor with the usual editing keys. Undo and redo there work on your typing, and these are worth knowing:
| Action | Mac | Windows and Linux |
|---|---|---|
| Search the text | ⌘ F | Ctrl F |
| Undo typing | ⌘ Z | Ctrl Z |
| Redo typing | ⇧ ⌘ Z | Ctrl Y |
Between panels
The gap between two panels can be moved from the keyboard too. Tab to it, then:
| Action | Mac | Windows and Linux |
|---|---|---|
| Resize a little | ← →, or ↑ ↓ above the Problems panel | ← →, or ↑ ↓ above the Problems panel |
| Resize more | ⇧ and an arrow key | Shift and an arrow key |
| Smallest or largest size | Home or End | Home or End |
| Close the panel | ↵ | Enter |
Double-clicking a gap puts the panel back to its usual size.
On a view-only link
People viewing a shared diagram can use ⌘ 0 (Ctrl 0) to fit it to the screen, + and - to zoom, and the same mouse and trackpad gestures to pan and zoom.
In option switches
In a row of options such as Theme or Provider in Settings, or the View switch above the diagram, ← and → move between the options.