Skip to content
Docs menu

Venom Notes

What Venom Notes is, where it lives, who can open it, and how its screen is laid out.

View .md

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.