Notes, links and history
Write notes in markdown, link them with [[wikilinks]], see what links back, and restore an earlier version.
Writing
Every note starts with its title, in large type, as in Notion. The title is the note's file name: change it and the
note is renamed, and every [[link]] to it is updated. It saves a second after you stop typing, when you click away,
or when you press Enter, which also moves you into the body (so do ↓ and → at the end of the title, and
↑ or Backspace at the very start of the body take you back). A title can't hold \ / : * ? " < > | # ^ [ ],
so those are dropped as you type. If another note in the folder already has the name, Notes says so under the title
and keeps what you typed; a title left empty goes back to what it was. New notes open with the caret in the title.
Notes are markdown. A note's name is its file name, and its folder is where it sits in the tree. The title isn't written into the note's markdown, so the file opens in Obsidian unchanged. Notes reads:
headings, lists, task lists (
- [ ]), quotes, tables, code blocks and horizontal rules;callouts, written Obsidian's way:
> [!tip] Title > Body#tags, and front matter at the top of a note. Front matter is shown as the note's properties:--- status: draft tags: [plan, launch] ---[[Note name]],[[Folder/Note name]],[[Note name#Heading]]and[[Note name|shown text]]links, and![[Note name]]embeds.
Notes shows notes as plain elements. It never runs HTML from a note, and only http, https and mailto links open
(in a new tab).
Notes saves as you type. There is no Save button. The bar above the note says Saving… while your latest edits are on their way, Saved once Notes has them, and Offline - changes will sync when the connection drops. Edits made offline wait in the browser, even if you close the tab, and are sent when you are back online.
Editing together
Several people can work in one note at the same time, as in Notion. Everyone's typing appears for the others within about a second, and two people typing in the same paragraph both keep what they wrote.
- Who is here. The circles in the bar above the note are the people on it, each in their own colour. A filled circle means they are here and active now. A ring means they are here but away (another tab, or idle), or that they looked at the note in the last half hour. Hover a circle to see their name and "Editing now" or "Viewed 3 min ago".
- Where they are. Other people's cursors and selections show in their colour, with their name on a small flag that fades when they stop moving. Hover the cursor to see the name again.
- In the file tree, a small circle on a note's row means someone else has it open.
- Changes from elsewhere. When a note changes outside the editor (an assistant writing over MCP, an Inbox suggestion you apply, a restored version, an import), the open note updates in place. If that change overwrote something someone had just typed, their text is kept in the note's history.
- In the organisation's vault, people who can't edit see the changes and the others' cursors, but the note is read only for them. A note in your own vault is only yours, so the circles there are you on your other devices.
- Undo (⌘Z) undoes your own changes, not other people's.
Links
Type @ to mention. It lists the people in your organisation, Venom Tasks issues, notes and dates that match what you
type next. A person becomes an @name, an issue becomes [[ENG-123]], a note becomes a [[link]] and a date becomes a
date you can click. Typing @today, @tomorrow or @2026-11-07 works too.
An issue link [[ENG-123]] is drawn as a live chip: the issue's state, its key and its title, which follow the issue as it
changes (the chip checks again every minute and when you return to the tab). A key that matches no issue in your
organisation stays an ordinary link, and [[ENG-123|your text]] shows your text.
Type [[ and Notes lists the notes whose names match what you type next. Pick one with the arrow keys and Enter.
Clicking a link opens the note it names. A link to a note that doesn't exist yet is drawn dimmed. Click it and Notes offers to create that note; once it exists, every link to it works.
If you rename or move a note, Notes rewrites the links that point to it in your other notes, and says how many it changed.
Beside the note
- Backlinks: the notes that link to this one, with the line each link is on.
- Unlinked mentions: notes that use this note's name without linking it.
- Outline: the note's headings. Click one to scroll to it.
- Local graph: this note and the notes one or two links away. Click one to open it.
- History: every saved version, with when it was saved and who saved it. Restore brings a version back. The version it replaces stays in the history, so you can undo a restore.
Search
Insight blocks. With Venom Experiments on, /insight embeds a live chart (a trend, funnel or retention query saved as an insight) in a page; the block is a fenced insight code block holding the insight's id, refreshes when the page is opened, and says "Insight unavailable" if the insight is gone or the reader has no access. A page of such blocks is a dashboard. See Insights and dashboards. With Venom Tasks on, the picker also lists Tasks' saved insights (id: tasks-<id>), counted as the reader; see Dashboards in Venom Tasks.
Press ⌘K (Ctrl+K) to search the open vault by title and by what is written in the notes. Title matches come first, and each result shows a one-line snippet of plain text around the first hit, with your words highlighted. Snippets are built from what you see in the note: markdown syntax, database blocks (shown as "Database: name") and code or Mermaid blocks are left out. The sidebar search box uses the same snippets and shows each note's folder under its title.
- Filters. Chips under the box narrow the results: Title only, Created by (me or someone else), In folder, and Edited (past day, week or month). A filter with an empty box lists the matching notes, newest first.
- Empty box. Recent notes are grouped under Today, Yesterday, Past week and Earlier, each with its folder.
- Preview. On a wide screen the highlighted result is previewed on the right.
- Keys. ↑ ↓ move, ↵ opens, ⌘↵ (Ctrl+↵) opens in a new tab. "Create …" is the last row when no note has that exact title.
Home
Opening a vault goes back to the note you last viewed in it (remembered in this browser). With none, the vault home shows recently edited notes as cards, the number of suggestions waiting in the inbox and the keyboard shortcuts. The side pane stays hidden until a note is open, and the vault list and file tree show from this browser's last copy while the fresh ones load (a failed load shows the error, not the old copy).
Today
The top of the vault home is today: the date, a button for today's note, the open Venom Tasks issues assigned to you (soonest due first, at most six, overdue ones in red, with a link to all of them on My issues) and a link to People's Today for who to contact. The task list shows only what Tasks would show you, and is left out when Tasks is off or you have none.
Today's note is Daily/YYYY-MM-DD in your own vault, made the first time you open it that day from the button or the calendar icon at the top of the file tree. It starts from the vault's Templates/Daily note when there is one. Otherwise it links back to your last daily note and copies its unchecked to-dos (at most 30) under Plan; a to-do whose [[ENG-123]] issue is done or canceled stays behind. The old note is left as it was. Opening Today again the same day opens the same note.
Ask AI
Select text and choose Ask AI in the toolbar for Improve writing, Fix spelling and grammar, Make shorter, Make longer, Explain, Summarize, Translate to…, Change tone…, or a free instruction. On an empty line, press Space (or type /ai) to write below: ask for text, or pick Continue writing, which reads the text above.
The answer streams into a card. Nothing changes in the note until you choose Replace (or Insert below), as one step that Undo reverses; Try again asks once more and Discard drops it. Edits replace the selection and show the original struck through above the suggestion; Explain, Summarize and the writing actions add new blocks below.
Ask AI uses the organisation's own gear through Venom Cloud, books each call like the Notes loop's, and counts against the daily limit for AI in Notes (Notes settings). It is hidden when the organisation has no gear with a model, or when today's limit is spent. The API is GET /globe/api/ai (availability) and POST /globe/api/ai (an event stream); nothing is written to a note by it.
Templates
Any note in a folder named Templates is a template. Its text can hold {{date}} (2026-11-07), {{time}} (09:05), {{title}} and {{author}}, filled in when a note is made from it.
- New note from a template. The ▾ next to the new-note button in the sidebar header lists the templates; ⌘K has a "New note from template…" row. The new note is titled with the template's name and today's date.
- Starter templates. The same menu has "Add starter templates", which adds Meeting notes, Decision record, Project brief and Weekly review to
Templates/. Edit them like any note. - Template button. Type
/buttonto add a button with a label. It either creates a note from a template in a folder you choose, or inserts the template's blocks right below the button. Hover a button while editing and use ✎ to change it. In the file it is a fenced block that Obsidian shows as code:
```button
label: "New meeting note"
action: create
template: "Meeting notes"
folder: "Meetings"
```The sidebar header
The sidebar header in Notes follows the same layout as Venom Tasks: the vault on the left, then search, which opens ⌘K, and new note. The top bar no longer carries a second search box.
Files and folders
Above the note, its folder path and title show as small crumbs. Click a folder to open it in the tree. Next to them is when the note was last edited, or whether it is saving.
Use the + buttons over the tree, or a row's ⋯ menu (or right-click), to make a note or a folder, rename one, or delete one. Drag a row to place it: a blue line shows where it lands, above or below another row. Drop it on the middle of a folder, or of another page, to move it inside (the page then shows a caret and its new sub-pages, as Notion's sidebar does; a database's rows can't take a page). Moving a note to another folder rewrites the links to it. The order is saved with your vault, so it follows you to other computers, and it stays out of your notes' markdown. With the keyboard, Alt+Shift+↑ and Alt+Shift+↓ move the focused row. A read-only vault can't be rearranged. Deleting a note moves it to the Trash (see page options, trash and favorites); deleting a folder asks first. Links to a deleted note stay in your other notes and show as unresolved.
A database shows in the tree with a database icon. Click its name to open the database as a full page, as Notion does; the arrow beside it (or → and ←) shows and hides its rows. Collapsing a folder works even when it holds the note you have open. The full-page database fills the window under the header, and an inline database in a note reaches toward the right edge of the page instead of stopping at the text column.