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
| Format | Type | Shortcut |
|---|---|---|
| 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.
| Action | Shortcut |
|---|---|
| Indent or outdent | Tab / Shift+Tab |
| Move a block up or down | Cmd+↑ / Cmd+↓ |
| Fold or unfold | Cmd+Shift+Enter |
| Zoom into a block | Cmd+. |
| Zoom out | Cmd+, 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."