Tutorials › Beginner

Your first hour
with Brainstead.

Follow one small, real-life job from start to finish, and learn the app as you go. No experience needed.

I'm using a

The steps and keys below follow your choice.

The story

You work at Acme, and the lease on your team's office ends in six weeks. Your manager, Sam, has asked you to organise the move to a new office and send a short proposal by Friday.

It's the kind of job that lives in your head, on sticky notes and in a dozen emails. By the end of this tutorial it will all be in one place, and you'll have a polished PDF to send Sam.

  • A projectfor the office move
  • Meeting noteslinked to it
  • A task listwith due dates
  • A proposalwith pictures, as a PDF
1

Install Brainstead.

Brainstead is free, needs no account and runs on your own computer. Installing it takes a couple of minutes.

  1. Download Brainstead for Mac. You need a Mac with Apple silicon (M1 or later) and macOS 14 or later.
  2. Open the downloaded file and drag Brainstead onto Applications.
  3. Open Brainstead from Applications. macOS says it can't check the app, because it isn't notarised by Apple. Click Done.
  4. Open System Settings › Privacy & Security, scroll down and click Open Anyway. From now on it opens normally.
  5. Brainstead asks for Full Disk Access, so it can read your notes wherever they are. Follow its instructions, or click Continue without it.
  1. Download Brainstead for Windows. You need Windows 10 or 11 (64-bit).
  2. Run the installer. It installs just for you, with no administrator password.
  3. If Windows says it protected your PC, click More info, then Run anyway. (The app isn't code-signed.)
  4. Open Brainstead from the Start menu.
Brainstead's welcome screen, with Choose folder and Create a new vault
The first thing you'll see: Brainstead asking where your notes live.
2

Make your vault.

Your vault is simply a folder on your computer where Brainstead keeps your notes. Each note is an ordinary text file, so your work is never locked inside the app.

  1. On the welcome screen, click Create a new vault.
  2. Give it a name, such as My notes, and choose where to keep it. Your Documents folder is a good place.
  3. Brainstead makes the folder, fills it with a few example notes and opens on Today, your home screen.
The Today screen: a summary of the day, a capture box and the tasks due soon
Today: what's due, what's coming up and a box to jot things down. The sidebar on the left takes you everywhere else.

Already keep notes in a folder? Click Choose folder… instead. Brainstead opens it read-only, so nothing changes until you turn Read-only off in Settings › Vault. A vault Brainstead makes for you is ready to write in straight away.

Lost? Press ? on any screen for help with it, or open the example note Start here for a tour.

3

Write your first notes.

Start with a note for the office move itself, then one for the kick-off meeting you had with Sam, Lena from facilities and Theo from IT.

A project note

  1. Press ⌘N (or click New note on the Notes screen) and choose Blank note.
  2. For Type enter Project, and for Title enter Office move. Clear the date: a project isn't tied to one day. Click Create.
  3. The note opens, ready to write in. Type a line about what the project is for:
    Our lease at Harbour Street ends on 30 November, so the team is moving to a new office.
  4. Press ⌘S to save.

A meeting note, from a template

  1. Press ⌘N again, and this time pick the Meeting template.
  2. When it asks what the meeting is about, type Office move kick-off and click Create. The note arrives with Attendees, Notes and Actions headings, and today's date in its name.
  3. Fill in who was there and what you discussed. Use the toolbar for bold, headings and lists, just as in a word processor.
The New note dialog with the Meeting template chosen
New note: start blank, or from a template that sets out the headings for you.

View and Edit. The switch at the top of a note moves between View, for reading, and Edit, for writing. Brainstead saves only when you press ⌘S, and keeps a draft as you type, so nothing is lost if you forget.

5

Add tasks to a note.

In Brainstead, a task is just a line in a note with a box in front of it. Write your actions where they came up, and Brainstead gathers them all onto one list for you.

  1. In the meeting note, under Actions, type a dash, a space and a pair of square brackets with a space between, then the task. (Or click the task-list button on the toolbar.)
    - [ ] Get three quotes from removal firms
  2. To give it a due date, type due: at the end of the line and pick a day from the calendar that pops up. It's shown as a small calendar icon and the date.
  3. Add a task you're waiting on someone else for, with the #waiting-for tag:
    - [ ] Theo to check the internet connection at Mill Lane #waiting-for
  4. Save, then open Tasks in the sidebar. Your new tasks are there with every other task in the vault, sorted by when they're due.
  5. Done one? Tick its box, here or in the note. The note is updated to match.
The Tasks screen with the office move tasks and their due dates
Tasks gathers every open task from every note, so nothing gets lost in the middle of a page.
6

Capture on the go.

You're in the middle of an email when you remember you need Lena's floor plan. Don't switch apps: catch it in two seconds and get back to what you were doing.

  1. From any app, press ⌃⌥Space. A small capture box appears.
  2. Type the task and press ↩:
    Ask Lena for the Mill Lane floor plan
  3. Had an idea rather than a to-do? Open the box again, press Tab to switch to Thought, and type it:
    Could we ask the landlord for the first month rent-free?
  4. Later, open the Inbox in the sidebar. Everything you captured waits there until you decide what it is: a task for the project, a note, or nothing at all.
The Inbox with the captured task and thought
The Inbox: everything you caught on the run, ready to sort when you have a minute.

Shortcuts as you type. In the capture box, due: fri sets a due date and @calls marks a task as a phone call, so Call the removal firm due: fri @calls is a complete task.

7

Write the proposal.

Now for the document Sam asked for: a clear, professional proposal with a table of options, a floor plan and a timeline.

  1. Press ⌘N, choose Blank note, and enter Report as the Type and Office move proposal as the Title. Keep today's date.
  2. Give it structure with headings: choose Heading 2 from the style menu at the left of the toolbar (it says Body text) for Summary, The options, The new floor, Timeline and Next steps. The note's name is already its title.
  3. Compare the two offices side by side: click the table button on the toolbar and fill it in.
  4. Add the floor plan: drag the picture from your desktop or an email into the note, or copy it and paste it with ⌘V. Brainstead saves a copy in your vault's images folder and places it where your cursor is.
  5. Too big? Point at the picture and drag a corner to resize it.
  6. Under the picture, add a short caption in italics (⌘I), then add the timeline the same way.
  7. Link the proposal from the project note, as you did in step 4, and save.
The proposal in Edit, with the floor plan picture and its caption
The proposal taking shape in Edit, with the floor plan embedded and its caption underneath.

Make a risk stand out. Start a line with > [!warning] and a title, and View draws it as a coloured box. Handy for the one thing Sam mustn't miss.

8

Change the look.

The same words can look plain or polished. Brainstead has seven themes for documents, each with a choice of colours, and you can give one note its own look.

  1. Switch the proposal to View.
  2. At the top right of the page, click the Look: button.
  3. Pick a theme. Point at each to read what it's like; Business gives coloured headings and banded tables, just right for a proposal.
  4. Pick a colour from the swatches. Dark blue looks smart for work.
The Look menu open on the proposal, with the Business theme chosen
Look: a theme and a colour for this document alone.

Like it everywhere? Set the look for every note in Settings › Notes › Document look. A note you've styled on its own keeps its look.

9

Export a PDF.

Last step: turn the proposal into a PDF you can attach to an email to Sam.

  1. With the proposal open, click the ⋯ button at the top right.
  2. Choose Export PDF… (or just press ⌘P).
  3. Choose where to save it, and click Save.

The PDF keeps your theme, colours and pictures, and puts the title and page numbers in the footer. Attach it to your email, and you're done.

The ⋯ menu open, with Export PDF
Export PDF, on the ⋯ menu.
The finished proposal in the Business theme, with the floor plan
The finished proposal, ready for Sam.

Rather paste it into an email? Choose Copy rich text on the same menu, and paste: headings, tables and formatting come with it.

You did it.

The office move is out of your head and into one place, and Sam has the proposal. Along the way, you learned to: