COMMONNOTE FIELD GUIDE

Find the feature.
Finish the task.

Search by what you want to do. Each section shows the exact path, the right view, and the details that are easy to miss.

01 · START HERE

Choose the shortest path into your work.

CommonNote can be a quiet personal notebook or a connected team workspace. You do not need to configure every layer before writing.

Open app→Create a note→Add structure when it helps
SOLO

Start with the note.

Create notebooks for broad areas, pin what is current, and turn only actionable lines into checklists or dated tasks.

PROJECT

Add a project lens.

Place existing notebooks in a project to read them as a hierarchy or relationship map. No duplicate copies are made.

TEAM

Share the source.

Invite an editor or viewer, then use comments, handoffs, messages, and reviews while the original note remains the anchor.

Five-minute setup

  1. Create one notebook for an active area such as Website launch, Semester, or Client work.
  2. Create a note and write the outcome, evidence, decisions, and next actions.
  3. Use a checklist for actions. Add @tomorrow or choose a due date when timing matters.
  4. Open To-dos to confirm the task appears with its Source Thread.
  5. Only then create a project, share the note, or add properties if the work needs them.
02 · NOTES AND FILES

Write, find, and connect source material.

Notes are the durable source. Tasks, project nodes, messages, and calendar items should lead back here instead of becoming detached copies.

All Notes→New note→Notebook · tags · content
NeedUseWhat to know
OrganizeNested notebooksDrag or choose a parent. A note can move without breaking its task Source Threads.
FindSearch, tags, favorites, recentSearch covers titles and content. Use tags across notebook boundaries.
ReuseTemplatesMark any note as a template, then create a fresh copy for repeatable work.
Connect[[note]] linksType double brackets to link another note. These links become dashed evidence on the relationship map.
AttachFile or Figure frameUse files for references; use Figure frames when placement, caption, size, or image presentation matters.
ProtectNote or notebook lockSet a password and inactivity timeout for sensitive private material.
Source Thread means every derived task keeps a route back to the note and notebook that created it. Use the Source button on a task card or the note-title cell in the schedule table.
03 · FORMATTING

Express the work without changing tools.

Select text for inline styles. Put the cursor in a block for headings, lists, quotes, code, tables, equations, and collapsible sections.

Open note→Editor toolbar
CategoryAvailable toolsBest use
BlocksHeading 1–3, bullets, numbers, checklist, quote, divider, collapsible blockMake long notes scannable and turn decisions into actions.
TextBold, italic, underline, strike, subscript, superscript, inline code, linksEmphasize meaning without inventing a new structure.
Visual marksFont, size, highlight, text color, custom color, emoji, Lucide, Phosphor, Tabler iconsCreate a consistent personal marking system for priority, status, or meaning.
Structured contentTable, code block, TeX equation, Figure frame, file attachmentKeep data, examples, formulas, and visual evidence beside the explanation.
Portable formatMarkdown import; MD, HTML, PDF exportBring text in and keep readable copies outside CommonNote.
App-level display zoom and editor font size are different. Use display zoom to scale the interface; use editor settings for text size, line height, table text, and document width inside the content frame.
04 · LIVE COLLABORATION

Work in the same note without hiding authorship.

Presence shows who is connected; live cursors show where they are working; block authors preserve who contributed the text.

Note header→Share→Username→Editor or viewer
  1. The note owner opens Share, enters a username, and chooses editor or view-only access.
  2. When both people open the note, participant avatars and connection state appear in the header.
  3. Live selections and cursors use participant colors. Changes sync without a manual save.
  4. Turn on Authors to see the author attached to each block.
  5. Select a passage and use Comments when the discussion belongs to exact text.
  6. Use version history before restoring or comparing a substantial change.

Editor

Can change content, comments, checklists, files, and shared structure.

Viewer

Can read without changing the note. Access remains account-based.

Connection state

A participant dot confirms the shared session. Reconnect before assuming an edit was lost.

Versions

Automatic checkpoints and manual versions can be compared and restored.

05 · HANDOFF AND REVIEW

Send work as an actionable brief.

A handoff carries the task, recipient, deadline, instructions, and a route to the source. It is not just a forwarded sentence.

To-dos→Task card→Paper plane
  1. Open list or card view and choose the task’s paper-plane action.
  2. Select one or more recipients. Their open-work count helps you avoid blind assignment.
  3. Choose today, tomorrow, Friday, next week, or a custom due date.
  4. Write the outcome, constraints, and where feedback should be left in the handoff memo.
  5. Send. CommonNote creates a high-priority notification and a direct-message record with an Open task route.
  6. Use Handoffs to follow who sent, accepted, or passed the work onward.

Review instead of handoff

Use a review request when ownership is not changing and you need a decision on completed work. The reviewer can complete the review or request changes; the source task keeps the review state.

A memo should answer three things: what “done” means, when it is needed, and which source contains the background. The Source Thread handles the last part; write the first two plainly.
06 · MESSAGES AND FILES

Talk and transfer files beside the work.

Messages are for coordination; note attachments are for durable storage. The visible + button in the composer opens the file courier.

Top message icon→Person or team→Message or + file
  1. Open Messages and choose a person or team already connected through your workspace.
  2. Press Enter to send; use Shift+Enter for a new line.
  3. Press + or Send a file now, then choose a file. One file can be up to 200 MB.
  4. Keep the panel open long enough to confirm upload progress reaches delivery.
  5. The receiver downloads from the message bubble. Filename, size, and delivery time remain in the conversation.
  6. Transferred file bytes are deleted automatically after 24 hours.
File courier is temporary. Put material that must remain available in a note attachment or Figure frame. Use messenger files for fast delivery, not as the archive.
07 · MIGRATION

Bring your history without flattening it.

CommonNote rebuilds notebooks from source folders where possible and carries supported attachments with the imported notes.

All Notes→Import→Choose or drop files
SourcePrepareExpected result
NotionMarkdown & CSV export ZIPPages, folders, images, and attachments
ObsidianZIP of the Vault folderMarkdown, folder hierarchy, Wiki links, and attachments
Evernote.enexNote body, title, timestamps, and attachments
Markdown.md or a Markdown folder ZIPHeadings, lists, checklists, tables, code, and images
  1. Keep the original export untouched before importing.
  2. Upload the file and read the success, skipped, and error counts.
  3. Inspect a representative note with nested folders, internal links, images, and checklists.
  4. After validation, download a complete CommonNote workspace ZIP as a recovery baseline.
08 · PROJECTS AND RELATIONSHIP MAP

Read structure and reasoning in two different ways.

The hierarchy answers “where does this belong?” The relationship map answers “why are these things connected?” Both use the same project scope.

Project tree→Hierarchy or Map

Build the hierarchy

  1. Create nested notebooks, then choose New project and place the relevant top-level notebook in it.
  2. Expand project → notebook → note → task to see ownership, status, due date, and completion.
  3. Use All, late, today, next seven days, or mine to filter the full tree.
  4. Open the source from a title; use the … menu for placement, actions, and handoff.

Build the relationship map

  1. Switch to Map. Add notes from the same project or create private memo cards.
  2. Drag cards to arrange them and use the corner handle to resize a memo.
  3. Select a source node, choose connect, and select the target node.
  4. Give the link a label, then set solid, dashed, or dotted line; arrow direction; width; and color.
  5. Use zoom buttons or enter an exact percentage. Fit width, choose frame size, or type an exact frame height.
Evidence Thread: automatic [[note]] links appear as dashed relationships. Links you draw to record a decision are explicit and can be styled independently.
09 · TASKS, SCHEDULE TABLE, AND CALENDAR

Choose the view that answers today’s question.

All views use the same underlying tasks. Change the view instead of copying the task into another planning system.

List

Fast scanning and compact editing across many tasks.

Cards

One actionable card with status, owner, due signal, and Source Thread.

Board

Move work across personal or workspace status columns.

Action compass

Jump directly to overdue, today, next seven days, or undated work.

Schedule table

  1. Open Calendar and select Table.
  2. Choose a primary hierarchy: task, date, status, or note.
  3. Add multiple groups such as month → person. Use Reorder to change group priority.
  4. Filter by status, person, and date, then choose a sort.
  5. Drag the handle before a column header to reorder it; drag the divider to resize it.
  6. Open Property to add select, number, date, person, relation, formula, or rollup columns.
  7. Use each header menu for visibility, calculation, and property-specific controls.

Calendar

  1. Select Calendar for the month view.
  2. Click an empty date for quick add or drag across dates to create a range.
  3. Click an item to edit content, color, completion, date, or deletion.
  4. Use D-Day chips, today and week progress, overdue, and acknowledgment signals to set priority.
  5. In task text, natural language such as @tomorrow 3pm, @next Fri, or @Mon~Fri creates dates.
10 · PROPERTIES AND AUTOMATION

Add structure where repetition starts.

Properties turn recurring task metadata into typed, filterable fields. Formula and rollup properties calculate across that structure.

PropertyUse it forExample
SelectControlled labelsChannel, priority, phase
NumberComparable amountsBudget, effort, score
DateAdditional milestonesReview date, publish date
PersonResponsibility beyond assigneeReviewer, requester
RelationConnect another task or recordDependency, related deliverable
FormulaCalculate from row valuesRemaining budget, elapsed days
RollupAggregate related valuesCount, sum, completion rate

Equation blocks

Use the Σ tool to insert TeX math into a note; use subscript and superscript for inline notation.

Progress

Group and person progress is calculated from visible task completion.

Repeating tasks

Choose recurrence days and ownership to create the next task on schedule.

Specialist calculator

When needed, the reagent calculator covers formula mass, molarity, moles, and dilution without defining the rest of the product.

11 · RECORDS AND BACKUP

Keep a trustworthy history—and a readable exit.

Version history helps with editing mistakes. Finalization and acknowledgment help when a particular state of the note must be attested.

Version history

Compare automatic checkpoints and manual versions, then restore the state you need.

Finalize

Freeze a snapshot and attach author, time, and a content hash.

Acknowledge

Record that another person reviewed the finalized state.

Lock

Password-protect a private note or notebook and set its inactivity timeout.

Backup routine

  1. Use MD, HTML, or PDF in the note header for a readable note-level copy.
  2. Use the top backup action for a complete workspace ZIP with attachments.
  3. Keep one copy in a separate storage location and test opening it.
  4. Before restoring or importing over existing work, download a fresh backup first.
14 · The daily flow

Let today find you first.

The morning digest, the notch, the widget, and the day board all show the same schedule so the day starts without opening the calendar.

Morning digest

  1. Open view settings (the sliders icon) › Work-life alerts and turn on Morning schedule digest.
  2. Pick a digest time. Leave it empty to match your work start time.
  3. On work days, one push arrives at that time with today's schedule (items due today and ranges covering today), overdue items, and pending handoffs.

Mac notch

Today's progress sits beside the notch. Hover to expand the list, then click an item to open or complete it. Turn it off in view settings.

Desktop calendar widget

Menu bar tray › Desktop calendar widget. A calendar sits beneath your other windows; hover a date to see that day's work.

Day board

Click a date in the calendar to open its board below. Items split into multi-day and single-day; click a card to open the note, or right-click / ⋯ to edit, complete, colour, or delete.

Mac notifications and location

The Mac app asks for notification permission on the first banner and for location when weather is on. If location is unavailable, type a city name and weather uses that.

13 · Import, snippets, API

Connect the schedules and tools you already have.

Apple Calendar comes in by file or subscription link, reusable phrases become snippets, and scripts or agents work through the Markdown API.

Apple Calendar import

  1. In the Mac Calendar app pick a calendar and use File › Export › Export… to save an .ics file, or copy an iCloud public share link (webcal://…).
  2. Press Import in the CommonNote calendar toolbar and drop the file or paste the link.
  3. Choose a range (for example from 30 days ago to a year ahead), check the preview, and press Add to calendar.
  4. Events land in the month sections of the 📅 Calendar note. Importing the same file again skips events that already exist.

Snippets

  1. View settings › Snippets: give it a name, an optional shortcut, and the text. Snippets are stored on your account, so they are the same on every device.
  2. In the editor type / and pick the snippet, or type ;shortcut followed by a space to expand it in place.

Markdown API

  1. Settings › Account security › API tokens: name it and create the token. The value is shown once, so copy it right away.
  2. Send Authorization: Bearer cnk_… with each request. Tokens only work under /api/v1.
  3. GET /api/v1/notes lists notes, GET /api/v1/notes/:id returns Markdown with Accept: text/markdown, POST /api/v1/notes creates a note, and POST /api/v1/notes/:id/append appends to one.

Service status

Click the traffic light in the top bar to see the web/API, realtime editing server, and app update feed. Full history at commonnote.app/status.

Backups and retention

Encrypted off-site backups run nightly, and trashed notes are purged after 30 days. Locked notes are left alone by the automatic purge.

12 · TROUBLESHOOTING

Check state before assuming data is gone.

Most confusing situations come from scope, filters, connection state, or a view setting. Use this order before changing data.

SymptomCheck
Another person’s edits do not appearConfirm both people opened the same note, participant connection is active, and the network is online.
A task is missingCheck My vs All, status/person/date filters, completed state, project scope, and Action compass selection.
Project map is emptyCreate a project, place a notebook in its scope, select the correct project lens, then add notes to the map.
Imported images are missingConfirm the export ZIP included the image files and relative paths were preserved.
File transfer failsConfirm the receiver is a connected collaborator, the file is under 200 MB, and storage is available.
Text or controls are clippedReset app display zoom, then adjust editor text and line spacing inside View options.
A column will not moveDrag the handle before the header, not the label or resize divider. Keyboard users can focus the handle and use arrows.

Useful shortcuts

ActionmacOS
New note / notebook⌘N / ⇧⌘N
Search notes⌘G
Bold / italic / underline⌘B / ⌘I / ⌘U
Heading 1–3 / checklist⌘1–⌘3 / ⌘9
Date / time⌘D / ⇧⌘D
Focus mode / sidebar⇧⌘. / ⇧⌘\
If the issue continues, send the browser and operating system, the exact screen, the shortest reproduction steps, and any visible error to CommonNote Support.

No matching section.

Search for the outcome instead of a feature name—for example, “send work to someone” or “move from Notion.”