VB Notes

Writing notes

Headings, lists, checklists, tables, code, diagrams, links between notes, pictures and voice notes, and the markdown behind each.

VB Notes shows formatting as you write and saves plain markdown. You never need to type the markdown yourself; the keys over the keyboard do it for you. It’s here so you know what ends up in the file.

Text

You see In the file
A heading ## A heading
Bold, italic, strike **Bold**, *italic*, ~~strike~~
Inline code `Inline code`
A quote > A quote
A link https://vbnotes.com (bare addresses stay bare)
A link to another note [[Trip to Ladakh]]

To make a heading, type # and a space at the start of a line (## for a smaller one). With the caret at the start of a heading its #s show in front of it, and Backspace there turns the heading back into text.

Type [[ and the first letters of a note’s title. A list of notes with those letters in the title comes up; pick one with the arrow keys and Return, a click or a tap. VB Notes writes the whole title and the closing ]] for you.

To open a linked note, tap it on the phone or ⌘-click it on the desktop (Ctrl-click on Windows and Linux). With the caret inside a link, an Open button also shows under it. A link to a title that no note has yet makes that note, so you can write [[Packing list]] first and fill it in later.

In the file a link stays [[Note title]], the way Obsidian and Bear write them.

Lists and checklists

- A bullet
1. A numbered item
- [ ] Something to do
- [x] Something done

Tap a checkbox to tick it.

Tables

Insert a table from the formatting keys. In the file it is a standard markdown table, which other apps show too.

Code

A code block is coloured by its language. Name the language after the opening fence, or leave it out and VB Notes guesses.

```js
const greet = (name) => `Hello, ${name}!`;
```

Diagrams

A code block marked mermaid is drawn as a diagram. Tap Edit to change the code behind it. Drawing needs an internet connection the first time; offline, the block shows its code.

A diagram is drawn at its own size, never wider than the note. Settings › Typography › Diagrams makes them all Small, Medium, Large or X-Large. Tap one twice or pinch it to zoom; on the desktop, double-click it.

```mermaid
flowchart LR
  Phone -- iCloud Drive --> Folder
  Desktop -- same files --> Folder
```

Pictures and voice notes

Add a photo, take one, or record a voice note from the bar over the keyboard, or paste a picture you copied. The file is saved in the folder’s attachments/ and linked from the note, so it travels with your notes. On the desktop you can also drop pictures on the note.

Pasting

Markdown you paste comes in formatted: - lines as a list, ## lines as headings, | tables | as tables. Text copied out of a terminal, such as a reply in Claude Code or opencode, is tidied first: its tables become tables, diagrams drawn with lines become code blocks, • bullets become a list, and lines the terminal broke at the window’s edge are joined again.

A terminal draws headings and bold without any marks, so they paste as plain lines. For an exact copy, use the app’s own copy command (/copy in Claude Code and opencode), which copies the reply as markdown. On the desktop, hold ⇧ as you paste (⇧⌘V, or Ctrl+Shift+V on Windows and Linux) to keep the text exactly as it is.

Saving from other apps

Share text, a link, a photo or a recording to Save to VB Notes from any app’s share sheet, and it becomes a new note.