Venom Notes
What Venom Notes is, where it lives, who can open it, and how its screen is laid out.
Venom Notes is a notes app inside Venom Cloud, in the spirit of Obsidian. You write markdown notes in folders and link them
with [[wikilinks]]. Each note shows its backlinks, outline and history beside it, and a graph view draws every note and
link at once. Notes uses your Venom Cloud sign-in and organisation, so there is no second account to make.
Where it is
| Address | What |
|---|---|
/globe |
the public page |
/globe/vault, /globe/vault/{id}-{title} |
the app: the open vault, and one note in it. The address carries the note's id and then its title in lowercase words joined by -, so you can tell notes apart in your history. Only the id matters: an old /globe/vault/{id} link still opens the note, and the address updates itself when the title changes |
/globe/graph |
the full-screen graph |
/globe/import |
bring in Notion, markdown folders, Obsidian vaults and ChatGPT and Claude history |
/globe/settings |
export, the keyboard shortcuts and how Notes learns |
If your deployment gives Notes a host of its own, the app is served at that host's root instead (/, /graph,
/settings), and the console host's /globe/vault sends you there. To set that up, see VENOM_GLOBE_HOST,
VENOM_GLOBE_ORIGIN and VENOM_COOKIE_DOMAIN in Self-hosting. Set
VENOM_CLOUD_ORIGIN as well, so that the Venom switch in Notes links back to the console's host.
Signed out, any of these takes you to sign-in first and back afterwards. Every member of the organisation can open Notes. Notes is an add-on to the organisation; while it is in preview every organisation has it. If yours doesn't, Notes shows Add Venom Notes with a link to the console's billing page.
The screen
- Left: the vault switcher, search, and the file tree. You can create, rename and delete notes and folders, and drag rows to reorder them or move them into a folder, as in Notion's sidebar. Rows you haven't placed are listed folders first, then by name.
- Middle: the open note, one at a time, with its folder path, title and save state above the editor. The editor has a source view, a reading view, and both side by side. Press ⌘K to jump to another note.
- Right: backlinks, mentions that aren't links yet, the outline, a local graph of the note's neighbours, and the note's history with Restore.
The side panes can be resized and folded, and Notes remembers that in your browser. On a phone, the side panes open as drawers.
Keyboard
| Keys | Does |
|---|---|
| ⌘K (Ctrl+K) | jump to a note, or create one with that name |
| ⌘N | new note in the current folder |
| ⌘S | save now (Notes also saves itself as you type) |
| ⌘G | the graph, and back |
| ⌘\ | show or hide the files |
| ⌘⇧F | search the vault |
| ⌘⇧D | star or unstar the open note (Favorites) |
[[ |
link a note: pick from the list |
In this section
- Notes, links and history: Write notes in markdown, link them with [[wikilinks]], see what links back, and restore an earlier version.
- Page options, trash and favorites: Give a note an icon and a cover, set its font and width, lock it, export it, bring back a deleted note, and keep favorites and recent notes above the tree.
- Share a note and publish it to the web: Invite people in your org to read one note, and publish a note as a read-only public page that search engines skip by default.
- The graph: Read the graph view, filter it, find a note in it, and what Notes draws it with.
- How Ask finds notes: How Ask in Notes and globe_note_related find notes by keywords, by meaning and by links, what needs an embedding model, how to run one on your own machine, and how well it works.
- Vaults, import and export: Switch between your personal, team and organisation vaults, start from sample notes, import an Obsidian vault and export one.
- Move notes between vaults: Move one note, a selection or a folder from one vault to another, with links, files and databases kept working, a clear warning about who can read them, and Undo.
- Import from Notion, Lark, Google Docs, Confluence and Evernote: Move a whole Notion workspace into Notes with an integration token, or bring a Notion export, Lark or Google docs, Word files, a Confluence space, Evernote notebooks or a folder of markdown, with nesting and links kept and a preview before anything is written.
- Sync a folder with venom globe sync: Keep a local folder of markdown, such as an Obsidian vault, and a Venom Notes vault in step both ways. Edits on both sides are merged three ways, overlapping edits keep both copies, and deletes only go to a trash.
- Import from ChatGPT and Claude: Bring what you have told ChatGPT and Claude into Notes from your own data export, or paste what your AI remembers, and review every suggestion before it reaches your vault.