Write and manage notes

A note holds your own Markdown. Use notes for thoughts, decisions, plans, checklists, preferences, project knowledge, and handoffs. Connected agents can also read and update notes when you allow them.

A note is editable. An item contains captured source material such as an article, video, email, or file. You can link an item to a note without changing the captured item.

For an overview with an example note and share link, see Markdown notes.

Create a note

1. Open Capture in Keep.
2. Select Write.
3. Enter a title.
4. Write the note in Markdown.
5. Select Save note.

You can leave the title empty. Keep uses the first non-empty line as the title.

You can also create a note with the CLI:

keep notes create --title "OAuth handoff" --body-file handoff.md

Voice notes

Voice notes require Personal. Record yourself instead of typing and Keep writes the note for you. For an overview with an example recording and note, see Voice notes.

1. Open Capture.
2. Select Voice.
3. Talk for up to 30 minutes. Select Pause and Resume if you need a break, then select Stop.
4. Select Play to check the recording if you like, then Save voice note.

Keep opens the new note while it works. The note shows Transcribing your voice note and then Cleaning up the transcript. This usually takes a few seconds for a short recording. The editor opens when the cleaned version is ready.

Once saved, the note stays visible if a progress check temporarily fails. Keep retries for about a minute before showing Try again. This checks the saved note again; you do not need to record or upload it again.

The cleaned version removes filler words such as “um” and “uh”, repairs false starts, adds punctuation and capitalisation, and splits the text into short paragraphs. It keeps your wording, meaning, numbers, links, and technical terms. It does not add headings, lists, or a summary unless you dictated them.

Keep gives the note a short title based on what you talked about. The note gets the voice tag. Both versions stay in the revision history: Raw transcript is the first revision and Cleaned up transcript is the second. Select the revision count below Properties to compare them or restore the raw transcript. Keep does not store the audio after the transcript is ready.

If transcription fails, the note says so. Record a new voice note to try again.

Edit and save a note

Open Notes from the sidebar. Select a note to edit it. The sidebar also shows your five most recently edited notes for quick access.

Keep saves changes after 30 seconds. Select Save changes to save sooner. You can also press Command+S.

Keep stores a recoverable draft in your browser while you edit. A failed save does not remove that draft.

The editor supports common Markdown shortcuts:

• Command+B makes text bold.
• Command+I makes text italic.
• Command+Shift+X adds a strikethrough.
• Command+K adds a link.

Use Markdown checkboxes for work that should appear on the Saved. Keep recognises open, in-progress, complete, and cancelled task markers.

Add properties

Open Properties above the editor. You can add these values:

• Kind describes the type of note, such as handoff or decision.
• State records a workflow state, such as open or closed.
• Tags help you find related notes.
• Custom properties store other structured values.

The token count is read-only. Keep calculates it from the note body with the o200k_base tokenizer. The editor also shows the line count and byte count.

Link an item to a note

Create a linked note when you want to add your own thinking to captured source material.

1. Open an item in Saved.
2. Select Add linked note.
3. Write the note in Markdown.
4. Select Create linked note.

The new note stays connected to the item. The item remains unchanged. Agents can read the linked source, highlights, and recent note history when they need more context.

The CLI can also attach an item or highlight. A link can describe the source as source, evidence, example, inspiration, or annotation.

Find notes

Use the search field on the Notes page to find words in note titles, Markdown bodies, and properties. Results update after you pause typing.

The notes page has three views:

• All notes shows every active note.
• Open notes shows notes with the open state.
• Agent edits shows notes last changed by a connected agent.

Use Keep search to search notes and items together. Use this CLI command to search notes only:

keep notes search "OAuth verification"

Review changes

Every saved change creates a revision. A revision records who made the change, which client they used, when it happened, and the supplied change summary.

1. Open a note.
2. Select the revision count below Properties.
3. Select a revision.
4. Review the added and removed lines.

To restore an older version, select Restore this version. Keep creates a new revision from that version. It keeps the current version and the full history.

Resolve an edit conflict

Keep checks the current revision before it saves a change. This check protects work when two clients edit the same note.

If another client saves first, Keep keeps your local draft and loads the latest saved revision. Select Use latest to discard the local changes. Select Save my version to save the local draft as a new revision.

CLI and API clients receive a revision conflict instead. Read the note again. Then retry the change with the new revision number.

Archive a note

1. Open the note.
2. Open the note actions menu.
3. Select Archive note.
4. Confirm the action.

Select Undo in the confirmation message to restore the note at once. Archiving and restoring both create revisions.

Share a note for review

Open the note actions menu, or right-click a note in the Notes list, then select Share note. Create the link and send it to anyone who should review the note. People with the link can read the latest saved version without signing in. Shared notes have a Shared marker in the Notes list. Their action menu shows Manage sharing instead of Share note.

To share several notes together, select the checklist button on the Notes page, choose up to 50 visible notes, and select Share selected. Keep creates one group link with navigation between those notes. The group is fixed after creation. Stop sharing it and create another link when you need a different selection.

The shared page does not expose your account, revision history, properties, tags, projects, or linked sources. It is read-only. Open Manage sharing from any included note to manage its group and single-note links. Each link can be copied, replaced, or stopped. Replacing a link immediately disables the previous link.

The same action menu can copy the private note link, copy the Markdown, or download that note as a Markdown file.

Export notes

Use the CLI to export all current and archived notes:

keep notes export --output ./keep-notes.zip

The ZIP contains one Markdown file for each note. The frontmatter contains the stable note ID, revision, timestamps, archive state, and custom properties.