Notes
PremiumThe Notes tool shows a vault, a folder of Markdown notes, as a tree next to your code. A note opens as a tab in the editor area, formatted as in Obsidian or as Markdown text. The tool's second page, Second Brain, manages your brains: folders of notes Claude works in. You need Obsidian for none of this, but the notes stay compatible with Obsidian.
Where to find it
- The Notes icon in the left stripe, out of the box in the lower group.
- Menu View › Tool Windows › Notes.
- Open as tab in the tool's bar brings it into the editor area at full size. Notes have no window of their own.
What you do here
- Create, rename and move notes and folders, filter by tag: Vault and notes.
- Write formatted, with toolbar, properties and attachments: Live Preview, Edit and Split.
- See and edit embeds, callouts, backlinks, canvases and bases: Display as in Obsidian.
- Let Claude rewrite text in a note: Rewrite text with Claude.
- Create and add brains and start Claude in them: Second Brain.
- See a brain as a graph with key figures: Overview.
- Maintain and check a brain as a mind map: Structure.
Layout of the tool
The tool adapts to its width:
| Width | Layout |
|---|---|
| narrow, for example in the sidebar | one page at a time, with the tabs Notes and Second Brain at the top |
| medium | one page at a time, each at full size |
| wide, for example as a tab | the tree on the left, the Second Brain page on the right |
The tool's vault sits at the top of the tree. You pick it freely; WebDonkey's active vault is only the default (Vault and notes).
If no vault is set up yet, it says "No vault set up yet. Create one under Second Brain or add a folder you already have." Go to Second Brain takes you there. If the editor found an Obsidian vault on your Mac, Use this vault offers it.
Free and Premium
Notes are entirely WebDonkey Premium. On Free the editor does not load the tool at all and shows the Premium note with See Premium instead. It also works without WebDonkey on this Mac: enter your licence key in the editor's settings (Enter license key).
Vault and notes Premium
The tree in the Notes tool shows the vault's folders, empty ones too, its notes and its other files such as pictures, PDFs, canvases and bases. Here you create notes and folders, rename, move and send to the Trash. The tree hides hidden folders such as .obsidian and .trash.
Where to find it
Open the Notes tool in the left stripe. If it is narrow, pick the Notes tab at the top. As a tab, the tree always sits on the left.
Choosing the vault
The vault sits at the top of the tree with a brain icon. A click opens the list:
- every vault from WebDonkey's list, including the brains created in the editor,
- Choose folder…: adds any folder to the list as a vault and picks it.
The choice applies in the editor only. WebDonkey's active vault is the default, and WebDonkey keeps its own. Hover over the field to see the vault's path. If the folder cannot be reached right now, the tree says The vault folder cannot be reached.
Below it sits the switch Load content from the web (Display as in Obsidian).
The bar above the tree
| Element | Effect |
|---|---|
| Search notes | filters by name. Hits are shown without their folders, with the folder as a hint |
| New note | creates a note in the selected folder, otherwise in the folder of the selected note, otherwise at the top of the vault |
| Open in Obsidian | opens the selected note in Obsidian. Only there if Obsidian is installed |
| Reload | reads the tree again |
How to do it
Open a note
Click a note. It opens as a tab in the editor area. A click on a folder expands or collapses it. Other files open in their view: pictures and PDFs as files, canvases and bases as in Obsidian (Display as in Obsidian).
New note or new folder
- Right-click a folder or the free part of the tree (that is the top level).
- Choose New note or New folder.
- Type the name right in the tree and press Enter. Esc cancels.
"Untitled" is suggested. A new note opens right away with the cursor in the text.
Rename
- Right-click, then Rename, or select the row and press F2.
- Type the new name and press Enter.
Links to the note follow, as in Obsidian. Open tabs follow the new name. You can also rename an open note with a click on its title above the text.
Move
- Drag a note, a file or a folder onto a folder in the tree. Dropped on the free part of the tree, it lands at the top of the vault. The target folder lights up, Esc cancels.
- Or right-click, then Move to …. The folder list filters with Find a folder, top level is the vault itself.
The editor only moves a folder after a confirmation (Move folder). Links to its notes follow. If the name already exists at the target, nothing is moved.
Move to Trash
Right-click, then Move to Trash, and confirm. The note or folder lands in the macOS Trash, where you can restore it.
Filter by tag
If you click a #tag in a note, the tool lists every note with that tag above the tree. #project also finds #project/client. The X closes the list. If no note has the tag, it says No note has this tag.
Rules for names
- Just a name, not a path: no "/".
- The name must not start with a dot.
- The name must not already exist in the folder.
Links
[[Name]] in the text jumps to the note of that name, also to a heading ([[Name#Heading]]). A note in another folder opens as a tab at that point. If no note has the name, a click creates it where the vault puts new notes.
Open in Obsidian
If Obsidian has never opened the folder as a vault, it shows its list of vaults. Choose "Open folder as vault" there and pick this folder. The editor puts the path on the clipboard: press ⌘⇧G in the folder dialog and paste it. Obsidian then sets up the folder as a vault itself.
What happens in the background
The editor reads and writes notes only through the note commands WebDonkey uses too, with their check: no path outside the vault works. A tab opened from a vault always saves into that vault, even if you have picked another one in the tree in the meantime.
Widget
The desktop widget Tasks shows the open tasks (- [ ]) from your notes (Widgets).
Troubleshooting
| Message | What to do |
|---|---|
| No note with that name. | Change the search |
| This vault has no notes yet. | Create the first one with New note |
| This name already exists here. | Choose another name |
| This path is not inside the vault. | Open the note from the tree |
See also
Live Preview, Edit and Split Premium
There are three ways to edit a note. Live Preview shows it formatted while you write, with the Markdown appearing only where the cursor is, as in Obsidian. Edit shows the Markdown text in the code editor. Split shows the text with the preview next to it.
Where to find it
Open a note from the Notes tool. The switch Live Preview · Edit · Split sits at the top right of the tab.
The choice applies to every note of the vault and in every window. Until you pick one, the editor follows what Obsidian has set for this vault: if Live Preview is off there, notes open in Edit, otherwise in Live Preview.
Live Preview
- Headings, lists, checkboxes, tables, links and embeds are shown formatted. Where the cursor is, you see the Markdown and change it directly.
- The note's name stands above the text as its title if the vault is set up that way. A click makes it editable, Enter renames the file, Esc restores the old name.
- The properties (the frontmatter) appear as fields above the text: Add property, Property name, Value, for lists Add a value, plus Remove property. Edit as text shows them as YAML.
[[suggests notes of the vault, aliases included.- Below the text are the Linked mentions: the notes that link to this one.
- Wrapped lines of a list item line up under its text, not under the bullet. macOS text replacements such as smileys from ":)" do not kick in here.
Undo, the dot for unsaved changes, autosave and the question after a change in Obsidian work as in the code editor.
Pasting and dropping files
If you paste a picture from the clipboard or drop a file onto the note, the editor stores it in the attachment folder Obsidian has set for the vault and inserts a link:
- pictures, audio, video and PDFs as an embed
![[…]], other files as a link[[…]]. - A pasted picture is named "Pasted image" with date and time, as in Obsidian; a dropped file keeps its name.
If the file cannot be stored, it says "The file could not be stored: …".
Edit
The Markdown text sits in the code editor with everything the editor can do. The note's name stands above the text, and a click on it renames the note.
Split
Split is Edit with the note's preview in a tile to its right. The preview shows the note the way Obsidian's reading view does (Display as in Obsidian). A click on Live Preview or Edit closes the preview again.
The Markdown toolbar
A toolbar sits above the text, in Live Preview as in Edit. Whatever does not fit the line goes under More.
| Button | Effect |
|---|---|
| Bold (⌘B), Italic (⌘I), Strikethrough, Inline code | format the selection |
| Heading | Normal text or Heading 1 to Heading 6 |
| Bulleted list, Numbered list, Checkbox, Quote | turn the lines into a list, task or quote |
| Code block | with a language or No language, inside a block also Remove code block |
| Link, Image | ask for an address or path |
| Horizontal rule | inserts a line |
| Insert table | pick the size (Columns × rows). With the cursor in a table, buttons for rows, columns, alignment and Align table join |
You hide the toolbar under Settings › Editor with Markdown toolbar or with the command Toggle Markdown toolbar in the View menu.
With Claude
- ⌘⇧E lets Claude rewrite the selected text, in both views (Rewrite text with Claude).
- If you select text in a note of a brain, the selection goes to Claude with the messages of a session that has this brain (Second Brain of a session).
Troubleshooting
- The switch is missing: the file is not a note from the Notes tool. Other Markdown files stay in the code editor.
- "A note name cannot contain any of these characters": pick a title without
\ / : # ^ [ ] |.
See also
Display as in Obsidian Premium
Notes look in the editor the way they look in Obsidian. Links resolve across the whole vault, embeds show their content in place, callouts, properties and tags appear as you know them. Canvas and base files open as their view and can be edited there. You do not need Obsidian for this.
Where you see it
- in a note's Live Preview,
- in the preview next to Edit when you choose Split (Live Preview, Edit and Split),
- in the tabs that canvas and base files open from the tree.
What is shown
| Element | How it appears |
|---|---|
[[Links]] |
resolve across the vault, also with heading or block. Targets not created yet are fainter, a click creates the note |
![[Embeds]] |
show the embedded note, a section or block of it, pictures, optionally with a width, PDFs, also from a given page, audio, video and canvases. Embedded notes embed further, up to a fixed depth and never themselves |
| Callouts | coloured boxes as in Obsidian |
| Properties | the frontmatter as a list of properties above the text |
#tags |
a click lists every note with that tag in the Notes tool (Vault and notes) |
| Linked mentions | below the note, the notes that link here. If there are none, it says No other note links here. |
Search blocks (query) |
show the search hits, otherwise No matches found. |
Base blocks (base) |
show a base's view inside the text |
| Diagrams | Mermaid diagrams are drawn |
If an embedded target is missing, it says it could not be found, or for one not created yet that a click creates it.
Canvas
A .canvas file opens as a canvas with its cards: text, notes, files, web pages and groups, connected by arrows. You edit it as in Obsidian:
- A double-click on the empty area adds a card, or you use the bar below: Add card, Add note from vault, Add media from vault, Add web page, Add group.
- You move and connect cards directly. A connection gets a Label, arrows (No arrows, Arrow at the end, Arrows at both ends) and a Color.
- Group the selection and Zoom to selection act on the selected cards. Undo and Redo are there too.
Bases
A .base file opens with its views over the vault's notes: table, cards or list, with the number of results. You edit views, filters, sorting, grouping and properties right in the view. Changing a cell writes to its note at once.
Open as text
Behind a canvas or base there is text (JSON or YAML). Right-click it in the tree, then Open as text, to open the file as text in the code editor.
Load content from the web
The switch Load content from the web sits in the tree below the vault's name and applies per vault. When it is on, pictures with a web address in the notes load on their own, as in Obsidian. When it is off, their place shows Load picture from …, and the picture loads only after a click.
What happens in the background
The display only reads the files. Writing happens only when you click or edit, for example when you create a note through a link. The editor writes canvases and bases a moment after the last change and before the tab closes.
Troubleshooting
- This canvas file cannot be read.: the file is not a valid canvas. Open it with Open as text and check it.
- "Unable to parse your base file": the base contains an error. Open it as text.
- A picture, audio or video says it could not be loaded: the file is missing or cannot be read.
See also
Rewrite text with Claude Premium
In a note you can have Claude rewrite selected text in place, just like Claudian's inline edit in Obsidian. You say in one sentence what Claude should do, see the change word by word and decide whether to keep it. This works in Live Preview as well as in Edit.
Where to find it
- ⌘⇧E in an open note.
- In Edit: right-click in the text, then Rewrite text with Claude.
How to do it
- Select the text Claude should change.
- Press ⌘⇧E. A card appears at the text. Its top says what is being edited, for a selection the selection with its lines.
- Type into the field ("What should Claude do? @ adds a file") what Claude should do, for example "shorter and without jargon", and send it with Enter. ⇧Enter makes a new line, Esc closes the card.
- While Claude works, it says Claude is writing….
- Claude shows its proposal as a word-by-word comparison: what goes away is struck through in red, what is added is highlighted.
- Accept puts the new text in and saves the note. Discard leaves everything as it was. Ask for something else starts a new attempt.
What Claude edits
| Situation | What is edited |
|---|---|
| Text is selected | the selection |
| Nothing selected, Claudian vault | the spot at the cursor, where Claude writes new text (At the cursor) |
| Nothing selected, other vault | the paragraph at the cursor (Paragraph at the cursor) |
Adding files and follow-up questions
- @ in the field suggests files and folders of the vault. What you pick goes to Claude as context.
- If Claude asks back, you answer in the same field ("Answer Claude…"). The answer goes into the same conversation.
[[Links]]in Claude's answer are clickable and open the note.
What happens in the background
The editor calls Claude Code in the vault's folder. In a Claudian vault, Claude starts with Claudian's settings. The request counts towards your Claude usage like any other. The text only changes once you choose Accept, and then as a single step that ⌘Z undoes.
Free and Premium
Part of Premium, like the notes. Claude Code must be installed and signed in (The window).
Troubleshooting
| Message | Why | What to do |
|---|---|---|
| No change | Claude's proposal equals the old text | Give a more precise instruction |
| Claude sent back nothing. | The answer was empty | Try again |
| Claude stopped before answering. Try again. | Claude Code broke off | Send again, otherwise check the sign-in in the Claude window |
See also
Second Brain Premium
The Second Brain page in the Notes tool manages your brains. A brain is a folder of Markdown notes, Claude's long-term memory: as in Claudian, as a WebDonkey brain or as your personal Second Brain. You start Claude in it or give it to a session in Mission Control. Brains are compatible with Obsidian, but you do not need Obsidian for them.
Where to find it
Open the Notes tool and pick the Second Brain tab. As a tab, the page sits to the right of the tree. In Mission Control the pencil Manage brains (Notes › Second Brain) leads here.
The page opens on the Overview of the active vault, if there is one. All brains takes you to the list.
The three kinds of brain
| Kind | What for |
|---|---|
| Claudian brain | notes you use in Obsidian with the Claudian plugin. Claude works here exactly as in Claudian, with the same settings, and you switch between Obsidian and the editor whenever you like |
| WebDonkey brain | WebDonkey's own memory for your projects. Notes get types and named connections, you see everything as a mind map, and the brain check finds gaps. Claude reads what it needs |
| Personal Second Brain | your own Second Brain. Claude asks you a few questions and then builds folders and rules that suit you |
How to do it
Create a new brain
- Click New brain.
- Enter a Name, for example "Clients".
- Check the Location. Out of the box the brain is created in the folder
Brainsin your Documents. Change… picks another location. - Pick the kind under How do you want to work with this brain?. Personal Second Brain is preselected.
- Click Create.
You then set up a personal brain with Claude: click Set up with Claude in the list. Claude starts in Mission Control inside the brain and leads the conversation.
Add an existing folder
- Click Add existing folder and pick the folder, for example an Obsidian vault.
- The dialog Add folder as brain shows the folder and how many notes it holds. Change… picks another one.
- Pick the kind. If the editor is sure what the folder is, one kind carries the label Fits this folder.
- Click Create.
A WebDonkey or personal brain without a CLAUDE.md gets the starter CLAUDE.md of its kind. A Claudian brain stays as it is.
Let Claude set it up from existing notes
If a folder has notes but nothing of a brain or an AI yet, the dialog also offers this for a Claudian or WebDonkey brain:
- Let Claude set it up from these notes: Claude looks through the notes in Mission Control and suggests a guide (Claudian) or folders, types and connections (WebDonkey). It only changes something after your yes, and nothing gets deleted.
- Make a backup first (a zip file next to the folder): on out of the box. The message afterwards names the backup's path.
Start Claude in a brain
Click Start Claude on the brain. A new session starts in Mission Control, with the brain's folder as start folder and the brain as its Second Brain. A Claudian brain starts exactly the way Claudian starts Claude (Second Brain of a session).
A brain in the list
| Element | Meaning |
|---|---|
| Name and path | what the brain is called and where it lives |
| Kind | Claudian brain, WebDonkey brain or Personal Second Brain. Change corrects a wrongly detected kind. This only changes the list, nothing in the folder changes |
| State | Ready, CLAUDE.md missing or Folder not found |
| Active in Notes | the tree is showing this brain right now |
| Claudian line | for a Claudian brain, what Claude starts with: model, permissions, effort, own prompt, number of environment variables, MCP servers and skills. Without Claudian settings in the folder, Claudian's defaults apply |
Below are the brain's buttons:
| Button | Effect |
|---|---|
| Set up with Claude | only for a personal brain whose setup is still open |
| Start Claude | a new session in the brain |
| Set up as brain | creates the starter CLAUDE.md of its kind if it is missing |
| Open in Notes | makes the brain the tree's vault and shows it |
| Overview | the brain's Overview |
| Open in Obsidian | only if Obsidian is installed. If Obsidian does not know the folder as a vault yet, the button reads Open in Obsidian as vault |
Obsidian (optional)
On the right, the box Obsidian (optional) explains that every brain is also an Obsidian vault. If Obsidian is not installed, it says that brains do not need it and where to get it. Nothing is installed into Obsidian.
If you open a brain in Obsidian that Obsidian has never opened as a vault, Obsidian shows its list of vaults. Choose "Open folder as vault" there and pick the folder. The path is on the clipboard: press ⌘⇧G in the folder dialog and paste it.
What happens in the background
- The list of brains is the same as in WebDonkey. A brain created in the editor shows up there too.
- The page itself writes nothing into a brain. Whatever creating or setting up adds only adds, such as a
CLAUDE.mdthat does not exist yet. Nothing existing is ever overwritten. - When you come back from Obsidian or the Finder, the page reads the list again. Reload at the top right does it right away.
Free and Premium
Second Brain is Premium, like the notes.
Troubleshooting
| Message | What to do |
|---|---|
| Claude Code not found. Set it up in the Claude window. | Set up Claude Code in the Claude window |
| A folder with this name already exists there. … | Pick another name or take the folder in with Add existing folder |
| This name doesn't work: … | Pick a name without a leading dot and without /, \ or : |
| Could not write to the vault. Check that the folder is writable. | Check the folder's permissions |
| Obsidian did not open. Is it installed? | Install Obsidian |
| This brain is no longer in the list. Reload the page. | Reload |
| Folder not found on a brain | Connect the drive or bring the folder back |
See also
Overview Premium
The Overview shows a brain at a glance: its notes as a living graph of dots and links, key figures, gaps, tags and where Claude works with the brain. From here you open notes and start Claude with this brain. It is the same view as on WebDonkey's Notes page.
Where to find it
- Notes tool, Second Brain tab: the page opens on the overview of the active vault.
- In the list of brains, the Overview button on a brain.
All brains at the top left goes back to the list.
The header
| Element | Meaning |
|---|---|
| Name and path | the brain |
| Copy AI guide | copies a short guide for any AI: how this brain is built and read, with its kinds of connection. Paste it into any chat |
| Start Claude with this brain | starts a session in Mission Control, inside the brain and with it as Second Brain |
| Overview · Structure | switches between the graph and the mind map |
The graph
Each dot is a note, each line a link. Larger dots have more links, the colour shows the top folder. Missing notes, that is link targets without a file, appear as dots of their own.
- Dragging moves the view, mouse wheel or pinch zooms.
- Hover over a dot to see how often it is linked and links itself.
- A click on a dot opens the note as a tab. If it belongs to another brain than the one in the tree, that brain first becomes the tree's vault.
- Find a note, folder or #tag searches the graph, Clear search resets it.
- Hide unconnected notes takes notes without a link out.
- The legend filters by top folder, Clear filter shows everything again.
- The buttons at the edge: Zoom in, Zoom out, Fit to view and Lay out again.
- Refresh reads the brain again.
The side panel
Show side panel opens four tabs on the right:
| Tab | Content |
|---|---|
| Summary | key figures (Notes, Links, Unconnected, Missing notes, Folders, Tags), plus Most connected and Recently changed |
| Gaps | Missing notes (a click shows in the graph who links to it) and Unconnected notes |
| Tags | every tag. A click on tags shows only their notes in the graph |
| Claude | Outside the brain: the Claude projects that start with this brain, and this month's sessions with it, with Sessions, Tokens and Cost |
The usage figures are estimated from the local transcripts at API list prices and count the sessions the editor started with this brain. A brain becomes part of a Claude project when you pick it as the project's brain (Projects).
Little room
In the sidebar the overview adapts to the width. If it gets too narrow for the graph, the tool shows a card with Open as tab instead. There is no full screen in the editor; the tab is the big view.
Empty and large brains
- This brain is still empty: Claude fills it while working, and you can write notes yourself too.
- This brain is very large: the overview covers part of it. The numbers then only count what was read.
Free and Premium
Part of Premium. Without Premium it says The brain overview is part of WebDonkey Premium.
Troubleshooting
- This brain is no longer in the list.: go back to All brains and reload the list.
- The folder is missing: the brain is on a drive that is not connected, or it was moved. The page then returns to the list by itself.
See also
Structure Premium
The Structure shows a brain as a mind map, the structure brain. Products are the main branches, functions the twigs, and named connections between notes run as arcs in the colour of their kind. Here you create notes from templates, connect them, give reasons for connections and let the Brain check test the brain. Everything you build here, the editor writes into the notes themselves.
Where to find it
- In the Notes tool, open the Second Brain tab.
- Open a brain's Overview.
- Pick the Structure tab at the top.
The mind map likes plenty of room: Open as tab in the tool's bar brings it into the editor area.
The bar
| Button | Effect |
|---|---|
| New note | creates a note from the template of its type, with frontmatter and required sections |
| Scaffold from code | reads a project folder and suggests notes for pages, commands, services and data |
| Check brain | starts the brain check |
| Read again | reads the brain again |
Below it you filter the map by Kinds of connection, Status (Every status), Product (All products) and Tag (Every tag). Reset filters clears them all. The search jumps to hits and expands the branches leading there.
How to do it
View and open a note
- Click a node. The side panel shows it with type, fields, required fields and required sections (present or missing) and its connections: Outgoing, Incoming and Mentioned in the text.
- A double-click on the node or Open opens the note as a tab.
Connect two notes
- Drag from a node's dot onto another node, or choose Connect in the side panel.
- In the New connection dialog you pick the Kind, the Target and optionally a Section of the target note.
- Under Why you write one sentence on why the connection exists. For some kinds this is required.
- Click Save. The connection is then in the frontmatter of the note it starts from.
Edit and Delete on a connection change or remove it again.
Create a new note
- Click New note, or New note here on a node.
- Enter Name and Type, pick the folder (Top level or a folder) and under Belongs to the parent node.
- As a folder with its folder note creates a folder with a note of the same name.
- Click Create. The note gets the sections of its template.
Rename
Rename in the side panel changes a node's name. Every link to it in the brain is updated along.
Brain check
Check brain tests the brain against its rules and shows the result in the side panel as errors, warnings and hints, for example:
- connection to a note that does not exist,
- link to a heading that does not exist,
- note without a type or without a status,
- required connection, required section or required field missing,
- connection without a reason (warum),
- code anchor no longer found,
- name used twice.
If there is nothing to report, it says No findings: the brain keeps its rules.
Scaffold from code
- Click Scaffold from code and then Choose project folder.
- The editor reads the code without changing anything and shows which notes would come into being along the click path. Notes that already exist are marked exists.
- Pick the notes (Select all, Select none) and click Create.
Only what is missing is created, existing notes stay as they are. You or an AI add descriptions afterwards. Recognised are, among others, Tauri apps, Astro, Shopware plugins, PHP projects with Symfony or Laravel and Node projects with React Router, Next, SvelteKit, Nuxt or Express.
Copy AI guide
The Copy AI guide button in the overview's header copies a short guide on how this brain is built and read, with its kinds of connection. Paste it into any chat so another AI reads the brain correctly too.
Vaults with their own rules
Not every brain uses types and status. A vault with its own rules still shows as a mind map: its connections are its links in the text and in the properties, and folders form the branches. It needs no type or status, and the editor only writes there when you do something. If a brain has no _brain folder, the start set of note types and kinds of connection applies. The side panel shows the matching note while no node is selected, together with the number of Nodes, Connections and Missing targets.
Free and Premium
Part of Premium. Without Premium it says The structure view is part of WebDonkey Premium.
Troubleshooting
| Message | What to do |
|---|---|
| The file changed in the meantime. The map was read again; please try once more. | Repeat the step |
| This name is already taken in the brain. | Choose another name |
| This folder cannot be read. Choose a project folder. | Pick another folder for the scaffold |
| This brain is very large: the map shows part of it. | Work with filters and search |