Notes
Write the workspace note in a block editor, insert blocks with /, draw Mermaid diagrams, attach files, send code to a terminal, and import or export Notion Markdown.
Each workspace has one note: a block-editor document for plans, findings, commands, and context that belong with the task. It is stored locally and saved automatically.
Block-editor notes arrived in 0.5.5 and Mermaid diagrams in 0.6.0. Both are Windows-only for now; the 0.5.3 macOS and Linux builds still have the earlier Markdown notebook.
Open the note
- Choose Notes in the workspace header, or press Focus notes (
Cmd/Ctrl+→). - The note opens as a pane in the workspace canvas. Whether the pane was open is remembered with the workspace.
The editor's labels are in English.
Write with blocks
An empty note says Type / for blocks, or paste Markdown.
- Type
/to open the block menu, then type to filter. The menu also matches Chinese block names and pinyin. - Paste Markdown and it becomes blocks.
- Hover a block to show its handle: Drag to move · Click for block actions. Block actions include Turn into, Duplicate, Move up, Move down, Delete, and Side by side with the block above.
- Select text to show the formatting toolbar: bold, italic, underline, strikethrough, inline code, and color and highlight.
Block menu
| Group | Blocks |
|---|---|
| Common | Task list, Bulleted list, Heading 1, Quote, Code block, Table |
| Basic blocks | Paragraph, Heading 1–4, Bulleted list, Numbered list, Task list, Quote, Callout, Code block, Divider |
| More blocks | Toggle list, Toggle heading 1–3, Content tabs, Button, Table and its row/column actions, Contents, Block equation, Inline math, Link, Bookmark |
| Columns | 2, 3, 4, or 5 columns |
| Media | Image, Video, Audio, File |
Contents inserts a table-of-contents block. Equations use TeX, up to 2,000 characters per formula.
Note shortcuts
Mod is Ctrl on Windows and Linux and Cmd on macOS.
| Action | Default |
|---|---|
| Bold / Italic / Underline | Mod+B / Mod+I / Mod+U |
| Strikethrough | Mod+Shift+S |
| Inline code | Mod+E |
| Highlight | Mod+Shift+H |
| Link | Mod+Shift+K |
| Block actions menu | Mod+/ |
| Move to the formatting toolbar | Alt+F10 |
| Duplicate block | Mod+Shift+D |
| Delete block | Mod+Shift+Backspace |
| Move block up / down | Alt+Shift+↑ / Alt+Shift+↓ |
| Open or close a toggle, tick a task, leave a code block | Mod+Enter |
| Send code block to terminal | Mod+Shift+Enter |
| Turn into paragraph / heading 1–3 | Mod+Alt+0 / Mod+Alt+1–3 |
| Turn into task / bulleted / numbered list | Mod+Alt+4 / 5 / 6 |
| Turn into toggle / code block / quote | Mod+Alt+7 / 8 / 9 |
On Windows, redo is Ctrl+Y, because Ctrl+Shift+Z stays Zen mode. Cmd/Ctrl+S saves the note right away. All of these can be changed in Settings → Shortcuts, in the Notes group.
Note options
The Note options (⋯) menu on the note pane applies each choice at once:
| Option | Default |
|---|---|
| Font style: Default, Serif, or Mono | Default |
| Small text | Off |
| Full width | Off |
| Table of contents | On |
| Import… | Notion export (.zip) or Markdown |
| Export… | Notion Markdown (.zip) |
With Table of contents on and at least two headings, a floating outline sits at the note's edge. Hover or focus it to list the headings; choose one to scroll to it. It is hidden in a narrow pane.
The note's base font size is set in Settings → Appearance → Note font (default 14).
Code blocks and diagrams
- A code block has a language button, Copy, and Send.
- A code block in the Mermaid language draws its diagram. Its Diagram view switch has Code, Preview, and Split; new diagrams start in Split. If the diagram renderer cannot load, the source is shown.
Send to terminal
Send (or Mod+Shift+Enter) pastes the code into the workspace's terminal tab. The tooltip names the tab, and the button then says Sent.
- The code is pasted, never run. Single-line code loses its trailing line end, so no Enter reaches the program.
- Multi-line code is sent only if the program has bracketed paste on. Otherwise it is refused, because a program such as
cmd.exewould run each line; you can choose Paste first line or Copy instead. - Code containing control characters is not sent.
- If the workspace has no terminal open, or its program has exited, the send is refused with a message.
Links
- Links must start with
http://orhttps://and contain no username or password. Ctrl/Cmd+click a link to open it in the workspace's Browser pane. AddShiftto open it in the system browser.
Attachments
Insert media from the Media group of the block menu, then choose the file. Attachments are copied into the note's own folder, outside your repository.
| Kind | Formats | Limit per item |
|---|---|---|
| Image | PNG, JPEG, WebP | 25 MB |
| Video | MP4, WebM | 100 MB |
| Audio | MP3, WAV, OGG, FLAC, M4A | 100 MB |
| File | Other files | 100 MB |
A file block offers Open and Show in folder. An attachment that cannot be found shows as missing.
Import and export
- Export… saves the note as a
.zipin Notion's Markdown layout, with its attachments. Cordy saves the note first. The command palette's Export note for Notion… does the same. - Import… reads a Notion export
.zipor a Markdown file and appends it to the end of the open note, as one step you can undo. The command palette offers Import into note… while the note pane is open. - Import skips Notion databases, keeps files linked inside the text as text, and leaves out attachments it cannot find. Cordy reports what was left out.
- An import that would push the note over its limit adds nothing.
Saving and limits
- The note saves automatically 800 ms after you stop typing.
- A note holds up to 1,100,000 characters and 150,000 elements. Over a limit, the note is not saved: your edits stay on screen, a message says by how much, and Show what's over the limit takes you there. It saves again once you are within the limit.
- An oversized paste is cut to fit, with an Undo paste action.
Conversion from Markdown notes
0.5.5 converts existing Markdown notes to the block format on first launch. Each original is kept as a backup next to the converted note and is never deleted. Going back to 0.5.4 or earlier after the conversion is not supported. See Privacy & Data for file locations.