---
title: Venom Notes
description: What Venom Notes is, where it lives, who can open it, and how its screen is laid out.
section: globe
order: 0
audience: [user, operator]
sources: [services/nodejs-cloud/components/globe/GlobeApp.tsx, services/nodejs-cloud/app/(globe), docs/adr/0048-knowledge-add-on.md]
features: [cloud.page-globe]
---

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](/docs/cloud/self-hosting.md#env-core). 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 {#in-this-section}

- [Notes, links and history](/docs/globe/notes.md): Write notes in markdown, link them with [[wikilinks]], see what links back, and restore an earlier version.
- [Page options, trash and favorites](/docs/globe/pages.md): 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](/docs/globe/share.md): 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](/docs/globe/graph.md): Read the graph view, filter it, find a note in it, and what Notes draws it with.
- [How Ask finds notes](/docs/globe/ask.md): 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](/docs/globe/vaults.md): Switch between your personal, team and organisation vaults, start from sample notes, import an Obsidian vault and export one.
- [Move notes between vaults](/docs/globe/move-between-vaults.md): 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](/docs/globe/import-from-apps.md): 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](/docs/globe/sync.md): 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](/docs/globe/import-from-ai.md): 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.
