Notes

A note is a Markdown file. You type plain text and blackbear shows the formatting as you write. Because a note is Markdown, you can download it and open it in any other Markdown app.

Make a note

  • On Desk, choose New, then Note. Start from a blank note or pick a template.
  • To bring notes in, open Import and drop Markdown files (.md, .markdown or .txt). Drop a folder, such as an Obsidian vault, and its subfolders come along.
  • Ask Pax to write one.

Format text

FormatTypeShortcut
Bold**text**Cmd+B
Italic*text*Cmd+I
Strikethrough~~text~~Cmd+Shift+X
Highlight==text==Cmd+Shift+H
Inline code`text`Cmd+E
Link[text](url)Cmd+K

On Windows and Linux, use Ctrl in place of Cmd. With a mouse or trackpad, selecting text shows a bar with the same options. Cmd+F opens find and replace.

Link notes together

  • Type [[ and start typing a title to link to another note. Click the link to open that note.
  • Type # to add a tag. A tag with spaces in its name is written #[Deep Work].
  • Type @ to mention a person. The mention is written @[Alex Chen].

Checklists and tasks

Start a line with - [ ] to make a checkbox, and click the box to tick it. To track an item in Tasks, put the cursor on its line and press Cmd+Shift+T. The line keeps a marker linked to the task.

Outline mode

Turn on Outline mode in the note's View menu. Each bullet becomes a block that moves, folds and zooms together with the bullets nested under it.

ActionShortcut
Indent or outdentTab / Shift+Tab
Move a block up or downCmd+↑ / Cmd+↓
Fold or unfoldCmd+Shift+Enter
Zoom into a blockCmd+.
Zoom outCmd+, or Esc

A bullet's menu has Copy block reference and Copy embed. Paste a block reference, written ((id)), to show that bullet's text in another note; click it to jump there. An embed shows the bullet and its children, read-only. {{embed [[Title]]}} embeds a whole note the same way.

Math and diagrams

Write math between dollar signs: $E = mc^2$ inside a line, or $$ ... $$ for a block of its own. blackbear draws it with KaTeX.

A code block marked mermaid draws a diagram from Mermaid text, in your theme. blackbear draws flowcharts, sequence diagrams, mind maps, timelines and ten more kinds, and Diagrams shows each one with an example. The text stays in the note, so other Markdown apps can still read it.

```mermaid
flowchart LR
  Idea --> Draft --> Done
```

Open as canvas draws the diagram on a new canvas you can edit freely, and the note keeps a link to it. After that, Open canvas shows it and Update canvas draws the note's text onto it again. Copy copies the Mermaid text.

Tables, images and views

  • Markdown tables (rows of cells between | bars) show as tables.
  • Paste or drag an image into a note to add it.
  • Typewriter mode, in the View menu, keeps the line you are writing in the middle of the screen.
  • Focus mode hides everything but the note. Press Esc to leave it.

Share, history and export

  • Share a note with a contact to write in it together. Changes are end-to-end encrypted.
  • Version history, in the file menu, lists earlier versions of the note. Open one and choose Restore this version to go back to it.
  • Download a note as Markdown (.md), or export it as HTML or plain text, from the file menu.

Pax

Pax can write notes for you, read the notes you point it to, and change one section or one bullet at a time. Ask in plain words: "Make a packing list for the trip" or "Tidy up the second section of my meeting notes."