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

GroupBlocks
CommonTask list, Bulleted list, Heading 1, Quote, Code block, Table
Basic blocksParagraph, Heading 1–4, Bulleted list, Numbered list, Task list, Quote, Callout, Code block, Divider
More blocksToggle list, Toggle heading 1–3, Content tabs, Button, Table and its row/column actions, Contents, Block equation, Inline math, Link, Bookmark
Columns2, 3, 4, or 5 columns
MediaImage, 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.

ActionDefault
Bold / Italic / UnderlineMod+B / Mod+I / Mod+U
StrikethroughMod+Shift+S
Inline codeMod+E
HighlightMod+Shift+H
LinkMod+Shift+K
Block actions menuMod+/
Move to the formatting toolbarAlt+F10
Duplicate blockMod+Shift+D
Delete blockMod+Shift+Backspace
Move block up / downAlt+Shift+↑ / Alt+Shift+↓
Open or close a toggle, tick a task, leave a code blockMod+Enter
Send code block to terminalMod+Shift+Enter
Turn into paragraph / heading 1–3Mod+Alt+0 / Mod+Alt+1–3
Turn into task / bulleted / numbered listMod+Alt+4 / 5 / 6
Turn into toggle / code block / quoteMod+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:

OptionDefault
Font style: Default, Serif, or MonoDefault
Small textOff
Full widthOff
Table of contentsOn
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.exe would 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 must start with http:// or https:// and contain no username or password.
  • Ctrl/Cmd+click a link to open it in the workspace's Browser pane. Add Shift to 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.

KindFormatsLimit per item
ImagePNG, JPEG, WebP25 MB
VideoMP4, WebM100 MB
AudioMP3, WAV, OGG, FLAC, M4A100 MB
FileOther files100 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 .zip in 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 .zip or 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.