Writing Notes

Every note in Heaper is a page you can type into. A title is optional. You can also write on files and photos. See Notes on images.

There are three ways to format text, and you can mix them freely:

  1. Type / to open a menu of everything you can insert.
  2. Type Markdown, such as # for a heading or - for a list. It turns into formatting as you type.
  3. Select text to get a small toolbar with bold, italic, color, link and more.

The / menu

Type / at the start of a line, or after a space. Keep typing to filter the list, use the arrow keys to move, and press Enter to insert. Press Escape to keep a plain /.

ItemWhat it does
Heading 1, 2, 3, Subheading, ParagraphText sizes for structure
Bullet List, Numbered List, Todo ListLists and checkboxes
Quote, Code Block, DividerQuotes, code and a horizontal line
TableA 3×3 table with a header row
2 Columns, 3 ColumnsPlace content side by side
Image, FileShow a photo or file from your heap inside the note
Embed blockShow another note live inside this one
Insert templateCopy part of another note here, then edit it freely
Daily Note NavigationPrevious and next links for daily notes
Habit Activity GraphA small activity chart for habit tracking

Linking notes together

Links are what make Heaper useful. Every link works in both directions. The other note shows where it was linked from.

  • @ links to anything. Type @ and a few letters, then pick a note, file or tag. This is called a mention.
  • # adds a tag. Type # and a word. Pick an existing tag or choose Create to make a new one. The note then appears under that tag.

While the search is open, press Tab to search only inside the highlighted item. Read Core Concepts for when to use a tag and when to use a mention.

To turn a web link into a saved bookmark, select the link and choose Create bookmark. Heaper saves a copy of the page and links it from your note.

Markdown shortcuts

Type these at the start of a line, followed by a space:

TypeYou get
# ## ###Heading 1, 2, 3
- or *Bullet list
1.Numbered list
[] or [ ]To-do checkbox
>Quote
```Code block
---Divider. In the first line of a note it opens the note's properties instead
|||Two columns

Inside a line:

TypeYou get
**bold**bold
*italic*italic
~~strike~~strike
`code`code
==highlight==highlighted text
++underline++underlined text
[text](https://…)a link

Keyboard shortcuts

Mod means Cmd on a Mac and Ctrl on Windows and Linux.

ShortcutAction
Mod+B / Mod+I / Mod+UBold / italic / underline
Mod+Shift+XStrikethrough
Mod+EInline code
Mod+Shift+LAdd a link
Mod+Alt+1 … Mod+Alt+6Heading 1–6 (Mod+Alt+0 for normal text)
Mod+Shift+8 / Mod+Shift+7 / Mod+Shift+9Bullet list / numbered list / to-do list
Mod+Shift+BQuote
Tab / Shift+TabIndent / outdent
Shift+EnterNew line without a new paragraph
Mod+FFind in this note
Mod+Z / Mod+Shift+ZUndo / redo

On a phone, a toolbar above the keyboard has buttons for undo, lists, to-dos, @, #, headings and indentation.

Moving and changing paragraphs

Hover a paragraph to show its handle on the left.

  • Drag the handle to move the paragraph.
  • Click or tap it for options: Turn into another type, Duplicate (Mod+D) or Delete.
  • On a heading, Collapse section hides everything below it until the next heading.
  • On a to-do, Promote to task block makes it its own block, which also shows up in the Tasks view.

Tables

Click a row or column edge for its menu. You can insert, duplicate, move, clear and delete rows and columns. Use the + buttons at the edges to add a row or column.

You can also type a Markdown table: a header line like | Name | Date |, then | --- | --- |, then press Enter.

Version history

Heaper saves snapshots while you write. To go back:

  1. Open the right sidebar.
  2. Select Version history (the clock icon).
  3. Drag the timeline to an earlier point. Turn on Diff to see what changed.
  4. Select Restore this version.

Writing together

Several people can write in the same note at the same time, and you can keep writing offline. Changes merge automatically when devices reconnect, without "conflicted copy" files. See Sharing to invite people, and What is a CRDT? for how this works.