Notes
PremiumThe Notes page is a Markdown editor for your notes, compatible with Obsidian. Your notes stay ordinary .md files in a folder, the vault. So you can switch between working here and in Obsidian, and nothing depends on WebDonkey. With Second Brain you turn such folders into the long-term memory of your projects for Claude.
What you do here
- Bring in one or more folders of notes: Choosing and managing vaults.
- Create, rename, move and delete notes, folders and files: Editing notes.
- Write formatted text as in Obsidian: Live Preview.
- See embedded notes, pictures, callouts, maths, diagrams and backlinks: Display as in Obsidian.
- Show and edit bases as a table, cards or a list: Bases.
- Show and edit canvas files: Canvas.
- View PDFs, pictures, audio and video in the vault: PDFs and media.
- Let Claude rewrite text or talk to Claude about the whole brain: Claude in your notes.
- Create brains, set them up and give them to Claude projects: Second Brain.
- Build a personal Second Brain with Claude: Personal Second Brain.
- See a brain as a graph of connections with its figures: Overview.
- Edit a brain as a mind map with named connections: Structure.
- Have notes proposed from the code of a project: Scaffold from the code.
- Find gaps and errors in a brain: Brain check.
Page layout
Top right, Second Brain switches to the list of your brains and Back to notes switches back. A green tick on the button means at least one brain is ready.
The notes view has the note list on the left with the active vault at the top, and the open note on the right with its toolbar: Rewrite text and Brain chat for Claude, then the views Live Preview, Edit and Split. The button on the left of the toolbar hides and shows the note list; drag its edge to change its width.
Before any vault is set up, the page shows Choose your notes folder with Choose folder, Create new brain and Auto-detect.
On the command line
The wd command line (More tools) reads and writes notes of the active vault, also with Premium:
wd notes # notes of the active vault
wd notes show <note> # print a note
wd notes new <path> [text] # new note, text from the arguments or a pipe
wd notes append <note> [text] # append text
Free and Premium
Notes and Second Brain are entirely Premium. Without Premium the page is locked with Notes is a Premium feature or Second Brain is a Premium feature. If Hide Premium features is on under Settings › Navigation, Free also hides the Second Brain button. Prices are at webdonkey.io/pricing.
Choosing and managing vaults Premium
A vault is a folder of Markdown files (.md), exactly the way Obsidian keeps it on disk. WebDonkey reads and writes these files directly, with no copy and no format of its own. You can add several vaults, for work, private notes and one per client, say, and switch between them at the top of the note list.
Where to find it
Sidebar › Tools › Notes. The active vault sits at the top of the note list. A click on it opens the Switch vault menu.
The first time
With no vault set up yet, the page shows Choose your notes folder with three ways:
- Choose folder: pick the folder that holds your
.mdfiles, your Obsidian vault for example. - Create new brain: creates a new folder as a brain for Claude (Second Brain).
- Auto-detect: WebDonkey looks for an Obsidian vault you already have on this Mac. It looks in
~/Documents,~/Obsidian, your home folder and Obsidian’s iCloud folder, each one level deep, for a folder with.obsidian. If it finds nothing, it says “No Obsidian vault found automatically. Choose the folder manually.”
Switching vaults
- Click the name of the active vault at the top of the note list. Below the name you see the kind of brain or the path.
- The Switch vault menu lists all vaults, the active one with a tick. A vault whose folder is missing shows not found.
- Click another vault.
When you switch back, a vault opens the note that was last open in this session and the view you chose for it. A change not yet saved lands in the right file before the switch. At the bottom of the menu you also find Add vault, Manage vaults and Show in Finder, plus the path of the active vault.
Adding a vault
- Switch vault menu › Add vault.
- Pick the folder.
- WebDonkey counts the Markdown files first. If the folder is empty or very large, it asks Use this folder as a vault?:
- empty: the folder has no Markdown files. If you use it anyway, new notes are created there.
- very large: WebDonkey stops scanning at a ceiling, so the list would stay incomplete and the page slow. That happens if you pick your Sites folder by mistake, for example.
- Add anyway takes it, Cancel does not.
The new vault becomes the active one right away. If you add a folder in Manage vaults instead, it only joins the list, without a question and without switching.
Managing vaults
Switch vault menu › Manage vaults opens a list of all vaults with name, path and the labels active and not found. Per vault:
| Item | Meaning |
|---|---|
| Load content from the web | pictures with a web address in the notes load on their own, as in Obsidian. Off: they load only on a click. Default: on |
| Rename | changes the name in WebDonkey only, not the folder (dialog Rename vault) |
| Remove | takes the vault off the list |
Add vault sits at the bottom.
Remove deletes not a single note: “The folder and every note in it stay exactly where they are.” Add the folder again later and everything is back unchanged.
What happens in the background
- WebDonkey only keeps the list of vaults (name, path, kind of brain, the web content switch) in its own database. The notes stay in your folder.
- While scanning, WebDonkey skips folders such as
node_modules,vendorand.gitand stops at a fixed ceiling. - With Load content from the web on, the view loads pictures that a note embeds by web address straight from the other server. Off: the spot shows Load picture from example.com, and only a click loads that one picture.
- The app backup has a category Notes vaults. It is not ticked by default and saves the Markdown notes of all vaults, without attachments and Obsidian settings (Backup).
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| not found at a vault | folder moved or drive not connected | connect the drive, or remove the vault and add it again |
| The list is incomplete | the folder is too large for a vault | choose a smaller subfolder as the vault |
| “No notes yet.” | the folder holds no Markdown files | create the first one with New note |
See also
Editing notes Premium
On the left is the note list of your active vault with all folders, notes and files, on the right the open note. Here you create notes and folders, rename them, move them by dragging and delete them to the Trash. Links to a renamed or moved file follow everywhere in the vault, as in Obsidian. Saving happens on its own.
Where to find it
Sidebar › Tools › Notes. With no vault set up yet, set one up first (Choosing and managing vaults).
How to do it
- At the top of the note list, click New note (plus icon).
- In the dialog Name of the new note, enter a name. With “folder/name” you create the note inside a folder right away; missing folders are created too.
- Click Create. WebDonkey adds the
.mdextension itself. The note opens. - Start writing. After a short pause in typing WebDonkey saves, and the indicator at the top changes from Unsaved to Saved.
The note list
The list shows what Obsidian’s file explorer shows: notes, PDFs, pictures, audio, video, canvas files and bases. Files that are not notes carry their extension as a small label (PDF or PNG, for example). A click on a folder folds it in and out.
| Item | Where | Meaning |
|---|---|---|
| New folder | top of the list | creates a folder at the top level |
| New note | top of the list | creates a note |
| New note in this folder | on a folder row, on hover | dialog New note in “folder” |
| New subfolder | on a folder row | dialog New folder in “folder” |
| Delete folder | on a folder row | moves the folder with everything in it to the Trash |
| Rename | on every file | dialog New name |
| Delete | on every file | moves the file to the Trash |
If the name exists already, WebDonkey says ““Project.md” already exists. Choose a different name.” and overwrites nothing.
Renaming
Renaming changes only the name; the folder stays. A note keeps .md, any other file its own extension, and the dialog says so: “The extension .pdf stays.” All links to the file follow, in the text, in properties and in canvas cards, and keep their form (wikilink or Markdown link).
Moving
Drag a note, a file or a folder onto another folder. The target folder lights up. Dropped on the free area of the list, it lands at the top level. A folder asks first: Move folder with “Links to its notes follow.” and Move. Links follow when moving, too.
Deleting
Deleting always asks and moves to the macOS Trash, from where you put the file back:
- Delete note: the question names the note and ends with “You can put the note back from there.”
- Delete file: the same for PDFs, pictures and other files.
- Delete folder: the folder with everything in it, including files the note list does not show.
The note’s toolbar
| Item | Meaning |
|---|---|
| Hide the note list / Show the note list | hides and shows the list on the left |
| Name of the note | plus Unsaved while typing, Saved afterwards |
| Rewrite text | Claude changes the marked text (Claude in your notes) |
| Brain chat | talk to Claude about the whole brain |
| Live Preview | write formatted text as in Obsidian (Live Preview) |
| Edit | the Markdown source in the code editor |
| Split | the source on the left, the finished display on the right |
For a canvas or a base, Live Preview shows the file’s own view and Edit its source (JSON or YAML). For PDFs, pictures, audio and video, Open in default app stands in place of the views. When the window gets narrow, the note list lies over the note as a sheet.
Which view a note opens in: the one you last picked for this vault, else what the vault’s Obsidian settings say, else Live Preview.
Width of the note list
Drag the edge between list and note to change the width. A double-click sets the standard width again. WebDonkey remembers the width and whether the list is open.
Tags and links
- A click on a tag such as
#projectlists all notes with this tag above the note list, nested tags like#project/clientincluded. The cross closes the list. If no note has the tag, it says “No note has this tag.” - A click on a link
[[Note]]opens the note, with[[Note#Heading]]at the heading. A link to a note that does not exist yet creates it where Obsidian would and opens it. - In Edit,
[[suggests notes, files and aliases.
What happens in the background
WebDonkey saves about 0.8 seconds after the last keystroke, when you leave the text field, and always before you open another note, another vault or another page. It writes the same file Obsidian reads, byte for byte, without reformatting. So you can switch between working here and in Obsidian.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| Premium required. in the toolbar | the licence is no longer Premium | activate Premium; your notes stay unchanged |
| “Select a note to start editing.” | no note is selected | click a note in the list |
| A file is missing from the list | files Obsidian does not show, the list does not show either | open it in the Finder (Switch vault menu › Show in Finder) |
See also
Live Preview Premium
Live Preview is the standard view of a note, as in Obsidian: you write in formatted text, and the Markdown only appears where your cursor is. Headings look like headings, links like links, tables like tables. On top you get an editor for the properties, a title above the note, suggestions while linking and Obsidian’s keyboard shortcuts.
Where to find it
Sidebar › Tools › Notes, open a note, Live Preview in the toolbar. Without a choice of your own, notes open in this view, unless the vault’s Obsidian settings turn Live Preview off.
How to do it
- Open a note and choose Live Preview.
- Write as in a word processor. Type
**bold**and you see the asterisks only while the cursor is in the word. - Click into a table, callout, formula or diagram to edit its Markdown. Leave the block and it is drawn again.
- Type
[[to link to another note and pick from the suggestions.
What Live Preview shows
- Text: bold, italic, highlights (
==…==), headings, lists, tasks with boxes, quotes, code. The Markdown characters hide while the cursor is not on them. - Blocks: tables, callouts, formulas, Mermaid diagrams, search blocks (
```query), base blocks (```base) and embeds on a line of their own look as the finished display shows them (Display as in Obsidian) until you click into them. - Title above the note: the file name as a heading. Change it and leave the field (or press Enter), and WebDonkey renames the note; all links follow. None of these characters is allowed:
\ / : # ^ [ ] |. If Obsidian turns the title off for the vault, it is off here too. - Linked mentions below the note: every other note that links here.
Properties
If the note has a YAML header (frontmatter), Live Preview shows it as a table of properties, with an icon for the type of each value.
| Item | Meaning |
|---|---|
| Value field | fits the type: text, number, date, date and time, checkbox, a list as chips (tags and aliases too) |
| Add a value | another entry in a list |
| Remove “x” | take an entry out of a list |
| Remove property | delete the whole property |
| Add property | Property name and Value of a new property |
| Edit as text | edit the header as YAML text, for nested values for example |
Each change rewrites only that one property. Comments and the order of the others stay as they are. If the YAML header is broken, it says Invalid properties, and you edit it as text.
Links and suggestions
After [[, Live Preview suggests the notes and files of the vault, by name and by every alias. Pick an alias and you get [[Note|Alias]]. After [[Note# come the headings of that note, after [[Note#^ its blocks. If a block has no ID yet, WebDonkey writes one in, as Obsidian does. The form of the link (shortest name, relative or absolute path, wikilink or Markdown link) follows the vault’s Obsidian settings.
A click on a drawn link opens its target, with ⌘-click also in the middle of the Markdown. A click on a tag lists the notes with this tag, a click on a task box ticks it.
Inserting files
Paste a picture from the clipboard or drag a file into the note, and WebDonkey stores it in the attachments folder Obsidian sets for the vault and writes the link:
- pictures, audio, video and PDFs as an embed
![[…]], other files as a link[[…]], with Markdown linksor[](…)accordingly. - A pasted picture is named “Pasted image” with date and time, as in Obsidian; a dragged file keeps its name.
Keyboard shortcuts
| Shortcut | Effect |
|---|---|
| ⌘B | bold |
| ⌘I | italic |
| ⌘L | tick or untick a task, turn a line into a task |
| ⌘/ | comment %%…%% |
| Tab, ⇧Tab | indent or outdent a list item |
| Enter | next list item, task or quote line; on an empty item the list ends |
| ⌘⇧E | rewrite text with Claude (Claude in your notes) |
What happens in the background
The text stays the note’s, byte for byte. Live Preview only formats the display; nothing is rewritten on loading or saving, line endings included. Saving works as in the other views, shortly after typing and when you leave the note.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| The note opens in Edit instead of Live Preview | the vault’s Obsidian settings have Live Preview off | pick Live Preview once; WebDonkey remembers it for the vault |
| “The file could not be stored: …” | the attachments folder cannot be written | check the folder’s permissions |
| Invalid properties | the YAML header is broken | edit it as text and fix it |
See also
Display as in Obsidian Premium
WebDonkey shows notes the way Obsidian’s reading view shows them: with embedded notes and sections, pictures, PDFs, audio and video, callouts, properties, search blocks, maths, Mermaid diagrams, footnotes and backlinks. Links work across the whole vault, and a click on a tag searches for it. So a note looks here exactly as it does in Obsidian, even when it was written there.
Where to find it
You see the finished display in the Split view, to the right of the source. Live Preview shows the same blocks while the cursor is not in them (Live Preview).
What is displayed
| Item | How to write it | Display |
|---|---|---|
| Wikilink | [[Note]], [[Note|Alias]], [[Note#Heading]], [[Note#^block]] |
clickable link, opens the note at that spot |
| Link without a target | [[New idea]] |
fainter; a click creates the note (“Not created yet: a click creates the note”) |
| Embedded note | ![[Note]], ![[Note#Section]], ![[Note#^block]] |
the note or section in place, with Open the note |
| Picture | ![[image.png]], ![[image.png|300]] |
the picture, with a width |
![[manual.pdf#page=3]], #height=400 |
the PDF at that page, at that height | |
| Audio, video | ![[sound.mp3]], ![[film.mp4]] |
a player |
| Canvas, base | ![[board.canvas]], ![[list.base]], ![[list.base#View]] |
the file’s own view |
| Callout | > [!info] Title, > [!tip]- Title |
coloured box with an icon; - starts folded, + open |
| Properties | YAML header between --- |
table of properties above the note |
| Search block | ```query |
embedded search, see below |
| Formula | $…$, $$…$$ |
typeset formula |
| Diagram | ```mermaid |
drawn Mermaid diagram |
| Footnote | [^1], ^[Text] |
footnote at the end |
| Highlight | ==Text== |
marked text |
| Comment | %%…%% |
hidden, across several lines too |
| Tag | #project, #project/client |
clickable tag |
| Task | - [ ], - [x] |
box; a click ticks it in the source |
Above the note its name stands as a title, below that its properties. Embedded notes embed further themselves, up to a fixed depth and never themselves.
Linked mentions
Below every note is Linked mentions: every other note that links here or embeds this note, in its text or its properties, each with the lines where that happens. A click opens that note at the matching heading. If nothing links here, it says “No other note links here.”
Search blocks
A ```query block with a search term shows the result like Obsidian’s embedded search: the search term as the heading, then one group per file with its title, the number of hits and every matching line, hits marked. A click on the arrow folds a group, a click on a title or line opens the file. If the search finds nothing, it says “No matches found.”
Tags
A click on a tag lists all notes with this tag above the note list, nested tags included (Editing notes).
Pictures from the web
When a note embeds a picture by web address, it depends on the vault’s Load content from the web setting (Choosing and managing vaults):
- on (default): the picture loads straight from the other server when shown, without a referrer, as in Obsidian.
- off: the spot shows Load picture from example.com. Only a click loads that one picture. The note reads “Loading content from the web is off for this vault.”
Only pictures are loaded. Audio, video and web pages from the web are never loaded by the display.
Free and Premium
The display as in Obsidian exists only on the Notes page and so with Premium. Other Markdown previews in WebDonkey, such as the one of a CLAUDE.md, show callouts, highlights, properties and wikilinks on Free as well.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| ““Plan” could not be found.” | the target of an embed does not exist | fix the name or create the note |
| ““Goals” is not in this note.” | the heading or block is missing in the embedded note | fix the section in the link |
| “This diagram could not be drawn:” with an error | the Mermaid diagram has a syntax error | fix the diagram in the source |
| ““image.png” could not be loaded.” | the file is missing or damaged | check the file |
| “This canvas file cannot be read.” | the canvas file is not valid JSON Canvas | fix it in Edit |
See also
Bases Premium
A base is Obsidian’s database view over your notes: it gathers notes by filters and shows their properties as a table, as cards or as a list. WebDonkey shows bases as Obsidian does and lets you edit them: views, sorting, filters, columns and formulas, plus the values in the cells. Everything you change ends up in the same files Obsidian reads.
Where to find it
Sidebar › Tools › Notes. A base appears in three places:
- as a
.basefile of its own in the note list, opened in the Live Preview view, - embedded in a note with
![[list.base]], or one particular view with![[list.base#View]], - as a
```baseblock right inside a note.
The Edit view shows the YAML source of a .base file.
How to do it
- Open a
.basefile or a note with a base. - Pick the view at the top left. Next to it is the number of hits, for example 12 results.
- Click into a cell to change the value of that property in the row’s note. Enter or leaving the field saves, Escape keeps the old value. Tick checkboxes right in place.
- Use the toolbar on the right to sort, filter or change columns.
A click on a file name or link in the base opens the file.
The toolbar
| Button | What it opens |
|---|---|
| View picker (left) | switch view, Add view, Edit view, Delete view |
| Sort | Group by (or No grouping), Sort by, Add sort, Direction: Ascending or Descending |
| Filter | conditions for This view or All views |
| Properties | show and hide columns, order them by dragging, Add formula |
| New | creates a new note that shows up in this view, and opens it |
The number on Sort and Filter shows how many rules apply right now.
Edit view
| Field | Meaning |
|---|---|
| View name | name as shown in the view picker |
| Layout | Table, Cards or List |
| Results limit | upper limit, default No limit |
| Image property | for cards, the property holding the picture, default None |
Filters
A filter is made of conditions in groups. For each group you pick the Conjunction: All the following are true, Any of the following are true or None of the following are true. Add filter adds a condition, Add filter group a subgroup, Add expression a free expression in Obsidian’s formula language.
A condition has a Property, an Operator and a Value. Depending on the type there are, for example, is, is not, contains, starts with, before, after, is empty, and for files also is in folder, has tag, links to and has property. Besides the properties of the notes, the file fields are available, for example file name, folder, created time, modified time, file size and file tags.
Columns and formulas
Under Properties you search with Search properties, show and hide columns and order them by dragging. Add formula creates a computed column: Name and formula, for example price * 1.19. Edit formula changes it.
In the table, every column header has a menu with Sort ascending, Sort descending and Hide. Drag the edge of a column header to set its width.
New
New creates a note “Untitled” that meets the view’s filters: in the required folder, with the required tags and values. If the name exists, WebDonkey adds a number. The new note opens.
What happens in the background
- WebDonkey writes changes to views, sorting, filters and formulas at once into the
.basefile or the note’s```baseblock. Comments, key order and anything WebDonkey does not know stay as they were. - A changed cell value changes only that one property in the YAML header of the row’s note.
Troubleshooting
| Message | Meaning |
|---|---|
| “Unable to parse your base file:” | the YAML file is broken; fix it in Edit |
| “View “Name” not found” | the embedded view does not exist in the base |
| “Failed to evaluate a filter: …” | an expression in the filter is broken |
| “Unknown view type: …” | the layout is not a table, cards or a list |
| “The function “x” is not supported here” | the formula uses a function WebDonkey does not know |
| “Could not save: …” | the file could not be written |
See also
Canvas Premium
A canvas is Obsidian’s free-form board: cards with text, notes, pictures or web pages that you arrange freely, group and connect with arrows. WebDonkey draws .canvas files as Obsidian does and lets you edit them. The file stays in the JSON Canvas format, and Obsidian opens it unchanged afterwards.
Where to find it
Sidebar › Tools › Notes, click a .canvas file in the note list. The Live Preview view shows the board, Edit the JSON source. Embedded in a note (![[board.canvas]]), a canvas is for viewing only.
How to do it
- Open a
.canvasfile. If it is empty, it says “Double-click to add a card, or use the bar below.” - A double-click on the free area adds a text card at that spot. Write the text in Markdown.
- Use the bar below to add more cards.
- Drag from a dot on the edge of a card to another card to connect the two.
- Every change is saved without you doing anything.
The bar below
| Button | Meaning |
|---|---|
| Add card | a text card |
| Add note from vault | a card showing a note; pick it with Search notes |
| Add media from vault | a picture or another file; pick it with Search files |
| Add web page | a card with a Web address |
| Add group | a framed area with a label |
In the corner sit Zoom in, Zoom out, Fit to view, Undo and Redo.
Cards and connections
Select one or more cards and a small bar appears above them:
| Button | Meaning |
|---|---|
| Edit | change the text of a text card or the label of a group (also by double-click or Enter) |
| Open file | opens the note or file of a card |
| Open web page | opens the address of a web page card in the browser |
| Color | No color, one of Obsidian’s colours or Own color |
| Group the selection | puts a group around the selected cards |
| Zoom to selection | fills the view with the selected cards |
| Delete | removes the selected cards |
Move cards by dragging them; a group takes the cards inside it along. Drag the edges of a card to change its size. Links in text cards open their note.
Select a connection and the bar shows Edit label (also by double-click), the direction No arrows, Arrow at the end or Arrows at both ends, Color and Delete.
If a card shows a note that does not exist, it says “Not created yet: a click creates the note”.
Keyboard shortcuts
| Shortcut | Effect |
|---|---|
| ⇧-click, drag a box | add to the selection |
| ⌘A | select all |
| Backspace or Delete | delete the selection |
| ⌘Z | undo |
| ⇧⌘Z | redo |
| ⇧1 | fit the whole canvas |
| ⇧2 | zoom to the selection |
| Esc | clear the selection |
Drag the free area with the mouse to move around; use the mouse wheel or a pinch to zoom.
What happens in the background
WebDonkey saves the file the way Obsidian saves it. The open file goes through the same automatic saving as a note. Rename a note that a canvas shows and the reference in the canvas file follows.
Troubleshooting
| What you see | What to do |
|---|---|
| “This canvas file cannot be read.” | check the JSON source in Edit |
| “Nothing found.” when picking a file | try another search term; the file has to be in the vault |
See also
PDFs and media Premium
PDFs, pictures, audio and video files in your vault appear in the note list next to the notes, in their folders. A click opens them right on the Notes page, without the Finder. In notes you embed them as in Obsidian.
Where to find it
Sidebar › Tools › Notes, click the file in the note list. Files that are not notes carry their extension as a label, for example PDF, PNG or MP3.
Reading PDFs
- Click a PDF in the note list. It opens at page width.
- Scroll through the pages. The text can be selected and copied.
- Use the bar at the bottom:
| Item | Meaning |
|---|---|
| Zoom out | zoom out |
| Zoom in | zoom in |
| Fit width | fit the page to the width of the view |
| Page counter | current page and number of pages, for example “3 / 12” |
Links in the PDF to web pages or mail addresses open in the browser or the mail app. Links inside the document jump to the spot.
Pictures, audio and video
WebDonkey shows a picture in the middle of the view, audio and video with a player. Recognised are pictures as PNG, JPG, GIF, BMP, SVG, WebP and AVIF, audio as MP3, WAV, M4A, OGG, 3GP and FLAC, and video as MP4, WebM, OGV, MOV and MKV. Whether an audio or video file plays depends on whether macOS can play its format.
Open in default app
At the top right, PDFs and media show Open in default app. It opens the file in the app macOS uses for it, for example to annotate, sign or print a PDF.
Embedding in notes
| How to write it | Effect |
|---|---|
[[Manual.pdf]] |
link, a click opens the PDF |
![[Manual.pdf]] |
the PDF embedded in the note |
![[Manual.pdf#page=3]] |
embedded, from page 3 |
![[Manual.pdf#height=400]] |
embedded, 400 pixels high |
![[image.png]], ![[image.png|300]] |
picture, optionally 300 pixels wide |
![[sound.mp3]], ![[film.mp4]] |
player in the note |
Paste or drag a file into a note in Live Preview, and WebDonkey stores it in the vault’s attachments folder and writes the link itself (Live Preview).
Renaming, moving, deleting
In the note list you handle PDFs and media like notes: Rename (the extension stays), move by dragging and Delete to the Trash. Links to the file follow when renaming and moving (Editing notes).
Troubleshooting
| Message | What to do |
|---|---|
| “This PDF is larger than 256 MB and is not shown here. Open it in your PDF app.” | Open in default app |
| “This PDF could not be opened.” | the file is damaged or no PDF; check it in the default app |
| ““image.png” could not be loaded.” | the file is missing or damaged |
See also
Claude in your notes Premium
In your notes you work with Claude in two ways: Rewrite text changes a marked passage or a paragraph right in the note, and you decide whether to accept the proposal. Brain chat opens a session with Claude in the whole brain, with your earlier chats. Both use Claude Code on your Mac and work the way the Obsidian plugin Claudian does it in Obsidian.
Where to find it
Sidebar › Tools › Notes, open a note. Both buttons are in the note’s toolbar, to the left of the views. Rewrite text exists only for notes, not for canvases or bases.
You need Claude Code on this Mac. Without it both buttons are grey, and the tooltip says “Claude Code is not installed on this Mac.” Set it up on the Claude page.
Rewrite text
- Mark the text Claude should change. Without a mark Claude takes the paragraph at the cursor; in a Claudian brain it writes at the cursor.
- Click Rewrite text or press ⌘⇧E. In Edit the command is also in the context menu as Rewrite text with Claude.
- A card opens next to the text. At the top it says what is being edited, for example “Selection, line 12”, “Paragraph at the cursor” or “At the cursor, line 12”.
- Type what Claude should do, for example “shorter and more matter-of-fact”.
@adds a file from the vault as context. - Click Send. While Claude works, it says Claude is writing….
- Claude shows its proposal word by word against the old text. Then you choose:
- Accept: the text is replaced and the note is saved at once,
- Discard: everything stays as it was,
- Ask for something else: a new instruction for the same passage.
If Claude asks back, answer in the field Answer Claude…. The answer goes into the same conversation. If Claude changes nothing, it says No change.
What happens in the background
For each rewrite, WebDonkey starts Claude Code once in the vault, with tools for reading and searching only, on the web too. So Claude can read files of the vault but change nothing; only your Accept does that. The edit is not stored as a session. In a Claudian brain Claude uses Claudian’s settings: model, effort, permission mode and environment. What Claude reads goes to Anthropic, as in any Claude Code session.
Brain chat
- Click Brain chat. The dialog Claude in this brain opens.
- Earlier chats in this brain lists your latest chats in this brain, chats from Claudian with the label Claudian. Resume carries on where a chat stopped. A chat that is running cannot be opened a second time.
- For a new chat, write your first message at the bottom.
@adds a file or folder. - Above the input field, Goes with every message: shows the open note and the marked passage (“Selection, line 12”). Leave out and Send along decide for each.
- Click Send. The dialog shows Claude Code in a terminal, and you carry on there.
As in Claudian, the open note goes only with the first message of a new chat, the marked passage with every message.
Closing keeps the session running; a green dot on the Brain chat button shows that. A click on Brain chat brings it back. New session ends the running session and starts a new one.
How Claude starts in the brain
| Kind of brain | Start |
|---|---|
| Claudian brain | exactly like Claudian: Claudian’s model, prompt and settings, with nothing of WebDonkey on top. New chats also show up in Claudian’s history in Obsidian |
| WebDonkey brain | with the read-only brain tools Claude uses to fetch single notes as needed (Brain check) |
| Personal Second Brain | with the brain tools and the rules of the vault: link format, attachments folder, daily notes, templates; while the setup is pending, with the setup (Personal Second Brain) |
You see and change the kind of a brain under Second Brain.
Free and Premium
Both belong to Notes and need Premium. Without Premium the buttons are grey with the tooltip Premium required.
Troubleshooting
| What you see | What to do |
|---|---|
| Buttons grey, “Claude Code is not installed on this Mac.” | set up Claude Code on the Claude page |
| “Claude sent back nothing.” | phrase the instruction more precisely and send again |
| “Claude stopped before answering. Try again.” | send once more; check that Claude Code is logged in |
| The chat does not show the open note | it only goes with the first message of a new chat; start over with New session |
See also
Second Brain Premium
A brain is a folder of Markdown notes with a CLAUDE.md: the long-term memory of a project for Claude. Claude reads in it what you and it wrote down earlier, and writes new findings into it. In Second Brain you create brains, bring in existing notes folders, pick each brain’s kind, start Claude in it and give brains to your Claude projects. You do not need Obsidian for any of this, but every brain is an Obsidian vault as well.
Where to find it
Sidebar › Tools › Notes, top right Second Brain. Back to notes returns to the notes view.
The three kinds of brain
When you create one, WebDonkey asks: How do you want to work with this brain?
| Kind | For | How Claude works in it |
|---|---|---|
| Claudian brain | notes you use in Obsidian with the Claudian plugin | Claude starts exactly as in Claudian, with the same settings. You switch between Obsidian and WebDonkey at any time. The brain gets no CLAUDE.md of its own |
| WebDonkey brain | WebDonkey’s own memory for your projects | notes get types and named connections, you see everything as a Structure, the Brain check finds gaps. Claude reads what it needs |
| Personal Second Brain | your own Second Brain for Obsidian | Claude asks you a few questions and then builds folders and rules that suit you (Personal Second Brain) |
For an existing folder, WebDonkey proposes a kind and marks it Fits this folder when it is sure: for a folder with Claudian set up, a WebDonkey brain or a setup still pending. If a kind is wrong, change it later with Change on the kind’s label. Nothing in the folder changes.
Creating a new brain
- Click New brain.
- Enter a Name, for example a client, a project or a topic.
- Location shows where the folder is created, by default
~/Documents/Brains/<Name>. Change … picks another parent folder. - Pick the kind. Personal Second Brain is preselected.
- Click Create.
WebDonkey creates the folder and writes the matching CLAUDE.md into it: a start guide for a WebDonkey brain, the setup guide for a personal Second Brain. Then it reports ““Client North” created” with the path. For a personal brain, Start setup with Claude and, if Obsidian is installed, Open in Obsidian appear right away.
Adding an existing folder
- Click Add existing folder and pick the folder.
- If the folder is empty or very large, WebDonkey asks Use this folder as a vault? Add anyway goes on.
- The dialog Add folder as brain shows Folder and “Notes in this folder: 42”. Change … picks another folder.
- Pick the kind.
- If the folder has notes but no AI setup yet and you pick Claudian brain or WebDonkey brain, the option Let Claude set it up from these notes appears:
- for a Claudian brain: Claude looks through your notes, suggests a guide for working with Claudian and only creates it after your yes,
- for a WebDonkey brain: Claude suggests folders, types and connections and only changes something after your yes. Nothing gets deleted.
- Below it, Make a backup first (a zip file next to the folder), on by default.
- Click Create.
With the option, a terminal with Claude opens next: A brain from the notes of “Project”. Claude shows you its proposal before it changes anything. WebDonkey names the backup with its path (“Backup: …”).
What WebDonkey writes: for a WebDonkey brain and a personal Second Brain the CLAUDE.md of the kind, but only if there is none. A Claudian brain stays as it is. WebDonkey never replaces an existing CLAUDE.md.
The list “Your brains”
Your brains shows every notes folder in WebDonkey and whether it is ready as a brain, so also the vaults you added on the Notes page. Check again reads the state anew.
Per brain:
| Item | Meaning |
|---|---|
| Name | a click opens the Overview |
| Kind label | Claudian brain, WebDonkey brain or Personal Second Brain, with Change |
| State | Ready, CLAUDE.md missing, Setup pending or Folder not found |
| shown in Notes | this brain is the active vault of the Notes page |
| Path | the folder, shortened with ~ |
| Claudian line | for Claudian brains, what Claude starts with, for example “Claude starts as in Claudian: model sonnet · permissions: ask first”; without Claudian settings Claudian’s defaults apply |
| Brain of … | the Claude projects that use this brain |
Buttons:
| Button | Meaning |
|---|---|
| Set up as brain | with CLAUDE.md missing: creates the CLAUDE.md of the kind; then ““Project” is a brain now” |
| Start Claude | opens a terminal with a new Claude Code session, the brain as working folder |
| Start setup with Claude | with Setup pending, in place of Start Claude (Personal Second Brain) |
| Overview | figures, graph of connections and structure of the brain |
| Open in Notes | makes the brain the active vault and switches to the notes |
| Folder icon | Show in Finder |
A brain is Ready when its folder is there and holds a CLAUDE.md. A Claudian brain needs none, Claudian brings its own prompt.
Starting Claude in a brain
Start Claude opens the dialog Claude in “Project”: a new Claude Code session with the brain as its working folder. Closing the window ends it; the conversation stays and can be resumed, for example on the Claude page under Sessions or with Brain chat in the notes (Claude in your notes).
How Claude starts depends on the kind: in a Claudian brain exactly as Claudian does. In WebDonkey brains and personal Second Brains, Claude also gets the read-only brain tools it uses to fetch single notes as needed instead of reading everything at once (Brain check).
Projects
Next to the list (below it in narrow windows) is Projects: “Give each Claude project its brain.” A Claude project is a name with its folders.
- Create a project with New project if there is none yet.
- In the project’s picker, choose its brain, or No brain.
Start a session of this project in Mission Control of WebDonkey Editor, and it gets the brain automatically. Brain no longer in the list in the picker means the assigned brain was removed.
Obsidian (optional)
Every brain is an Obsidian vault as well. With Obsidian installed, the panel Obsidian (optional) appears, and every row has Open in Obsidian. If Obsidian does not know the folder yet, the link reads Open in Obsidian as vault:
- Click Open in Obsidian as vault. WebDonkey puts the folder’s path on the clipboard and opens Obsidian’s list of vaults.
- The message One more step in Obsidian explains: choose “Open folder as vault” in Obsidian and then this folder.
- Press ⌘⇧G in the folder dialog and paste the path.
Without Obsidian there is just one line saying you do not need it, with Get Obsidian. WebDonkey installs no Obsidian plugin and never writes into the .obsidian folder.
What happens in the background
- WebDonkey keeps only the list of brains with their kind and the assignment to projects in its own database. All notes stay files in your folder.
- Writing follows one rule: add what is missing, never replace. An existing
CLAUDE.mdis yours. - What Claude reads from the brain goes to Anthropic. WebDonkey itself sends nothing.
- The backup before Claude’s setup is a zip file next to the folder. It stays until you delete it.
Free and Premium
Second Brain is Premium. Without Premium the area shows Second Brain is a Premium feature.
Troubleshooting
| Message | What to do |
|---|---|
| “Claude Code is not installed on this Mac.” | Set it up on the Claude page (Claude Code) |
| “This name does not work as a folder name: …” | a name without /, \ and :, not starting with a dot |
| “A folder with this name already exists there. …” | pick another name or use Add existing folder |
| “Your Documents folder was not found. Choose a location for the brain.” | pick a location with Change … |
| Folder not found | folder moved or drive not connected |
| “Obsidian could not be opened. Is it installed?” | install Obsidian |
| “The backup could not be made: …” | check space and permissions next to the folder |
See also
Personal Second Brain Premium
A Personal Second Brain is your own note system for Obsidian that Claude builds together with you. Claude leads you through the setup, asks about you, your projects, areas and topics, and then creates folders, context notes and rules of your own that suit you. Afterwards Claude works in this vault like an assistant right inside Obsidian.
Where to find it
Sidebar › Tools › Notes › Second Brain. A personal Second Brain comes from New brain or Add existing folder with the kind Personal Second Brain (Second Brain).
How to do it
- Create a new brain and leave the kind Personal Second Brain selected, or pick it for an existing folder.
- WebDonkey puts the setup guide into the folder as
CLAUDE.md, if there is noCLAUDE.mdthere yet. The brain now shows Setup pending. - Click Start setup with Claude. The dialog Setup of “My brain” with Claude opens a terminal with Claude Code in the folder.
- Claude starts on its own and leads you through the setup step by step, one question at a time.
- At the end Claude sums up what it wants to create. Only after your yes does it build the folders, context notes and the new
CLAUDE.mdwith the rules of your vault. - Optional: Open in Obsidian to use the new vault in Obsidian.
Closing the window ends the session; the conversation stays and can be resumed. As long as the guide is still the folder’s CLAUDE.md, Setup pending stays, and Start setup with Claude picks up there.
What Claude asks
The setup runs in phases:
- greeting and a check of what is already in the folder,
- your personal profile,
- your projects,
- your areas, meaning lasting responsibilities,
- your resource topics,
- your context profile, optionally with quick inputs,
- summary and your confirmation,
- building the vault.
Claude creates folders and notes only once you agreed to the structure.
Obsidian Skills and plugins
The setup relies on the Obsidian Skills, a set of skills for Claude around Obsidian (MIT licence, on GitHub). If they are missing from the .claude/skills/ folder, Claude asks whether it may download them from GitHub and install them there. It downloads them only after your explicit yes. If you say no, Claude briefly explains why they are needed and only goes on once you installed them yourself or explicitly want to continue without them.
For folder icons in Obsidian, Claude recommends the community plugin “Iconize”. It is not required; without it only the icon step is skipped.
In Obsidian vaults of your own
Once the setup is done, or when the folder already has rules of its own, Claude follows the habits of the vault in a personal Second Brain. When it starts, it gets rules from the Obsidian settings:
- the vault’s
CLAUDE.mdcomes before every other hint, - Obsidian Markdown with wikilinks, embeds, properties, tags and callouts,
- the vault’s link format (shortest name, relative or absolute path, or Markdown links),
- the attachments folder, the folder and naming scheme of daily notes and the templates folder,
- folders, names, properties and tags as in the existing notes.
Claude does not add the fields of a WebDonkey brain (type, status, connections) here, unless the vault uses them already.
What happens in the background
- WebDonkey itself downloads nothing. Claude Code holds the conversation and sends it, with the notes it reads, to Anthropic. Claude Code downloads the Obsidian Skills from GitHub after your yes.
- WebDonkey writes the setup guide in German when the app is set to German, otherwise in English. Claude holds the conversation in your language.
- WebDonkey never replaces an existing
CLAUDE.md. At the end of the setup Claude replaces the guide with the rules of your vault.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| Start setup with Claude is grey | Claude Code is not installed | set it up on the Claude page |
| No Setup pending although you picked a personal brain | the folder already had a CLAUDE.md |
open Claude with Start Claude; it follows your CLAUDE.md |
| Open in Obsidian is missing | Obsidian is not installed | install Obsidian or work without it |
See also
Overview Premium
The Overview shows a brain at a glance: how many notes it has, how they connect, what is linked but missing, what changed last and which tags exist. At its centre is a graph of connections, where every dot is a note and every line a link. Next to it you see which Claude projects work with the brain and what their sessions used this month.
Where to find it
Sidebar › Tools › Notes › Second Brain, click Overview or the name at a brain. At the top are the tabs Overview and Structure (Structure). All brains goes back to the list.
How to do it
- Open the overview of a brain.
- Hover over a dot in the graph. Its neighbours light up, and a tooltip shows “Linked from: 3” and “Links to: 5”.
- Click a dot to open the note in the notes.
- Search for a note with Find a note, folder or #tag. Enter shows the first hit in the graph, Esc clears the search.
- Look under Gaps in the side panel on the right to see which notes are missing or unconnected.
Header
| Item | Meaning |
|---|---|
| All brains | back to the list of brains |
| Name and path | the brain and its folder |
| Copy AI guide | puts a short guide for any AI on the clipboard: how this brain is built and read, with its kinds of connection. Afterwards it briefly says Copied |
| Start Claude with this brain | opens a terminal with Claude Code in the brain, when the folder is there and Claude Code is installed |
The bar above the graph
| Item | Meaning |
|---|---|
| Find a note, folder or #tag | highlights matching notes, on the right the number of hits and Clear search |
| Hide unconnected notes | hides notes without a link in or out |
| Refresh | reads the brain again |
| Hide side panel / Show side panel | hides and shows the side panel with figures and lists |
| Full screen | puts graph and side panel over the whole window; Exit full screen or Esc ends it |
The graph
Every dot is a note, every line a link. Bigger dots have more links; the colour shows the top folder. Linked notes that do not exist yet appear as Missing note with a dashed outline.
- Move: drag the free area or move with two fingers on the trackpad.
- Zoom: mouse wheel or pinch, or the buttons Zoom in and Zoom out.
- Fit to view shows everything, Lay out again spreads the dots anew.
- Legend: at the bottom are the top folders with their colour and count, Top level for notes without a folder. A click on a folder shows only its notes; several can be combined. Clear filter resets folder and tag filters.
The side panel
| Tab | Content |
|---|---|
| Summary | figures: Notes, Links, Unconnected, Missing notes, Folders (subfolders included), Tags. Plus Most connected (“The notes everything else hangs on.”) with Linked from and Links to, and Recently changed |
| Gaps | Missing notes: link targets without a file; a click shows in the graph who links them. Unconnected: notes no other note links and that link nothing |
| Tags | all tags with their count; a click shows only their notes in the graph |
| Claude | Outside the brain: the Claude projects that start with this brain, and Sessions in the current month with Sessions, Tokens and Cost |
A click on a note in a list opens it; on hover it lights up in the graph. The Gaps tab shows the number of missing and unconnected notes.
The figures under Claude cover sessions WebDonkey Editor started with this brain. They are estimated from the local transcripts at API list prices. If no project starts with the brain yet, the page explains how to give it to a project (Second Brain).
An empty brain
If the brain has no notes yet, it says This brain is still empty: Claude fills it while you work with decisions, findings and how-tos, and you can write notes yourself as well. Below that are Start Claude with this brain and the connections outside the brain.
What happens in the background
The overview only reads the brain’s notes. For very large brains it reads at most 5,000 notes and 1 MB per note and then shows “This brain is very large: the overview covers part of it.” The figures then count what was read.
Troubleshooting
| Message | What to do |
|---|---|
| “The brain folder is not there …” | move the folder back or connect the drive |
| “This brain is no longer in the list.” | go back with All brains and add the brain again |
| “The usage could not be read.” | open it again later; Claude Code’s transcripts could not be read |
See also
Structure Premium
The Structure tab shows a brain as a mind map: the brain in the middle, products as the main arms, functions as branches, and the named connections between notes as coloured arrows, one colour per kind of connection. This is where you organise a WebDonkey brain: you draw connections, give them a reason, create new notes from the brain’s templates and rename nodes. Everything you do here, WebDonkey writes into the notes themselves.
Where to find it
Sidebar › Tools › Notes › Second Brain, Overview at a brain, then the Structure tab at the top.
Terms
- Node: a note or a folder in the brain.
- Type and status are in a note’s YAML header (
typ,status). The status is active, planned, on hold, replaced, removed or missing (no status). - Connections are in the YAML header too, each with a Kind (for example
gehoert-zu), a Target and, if you like, a sentence Why. Mentions in the text (wikilinks) count as Mentioned in the text. - Which types and kinds of connection exist, a WebDonkey brain defines in its
_brainfolder. Without it, a start set applies.
How to do it
- Open the Structure tab.
- Click a node. On the right, under Details, you see its fields and connections.
- To connect two nodes, drag from the dot on the edge of one node onto another node.
- In the dialog New connection, pick the Kind, check the Target and write the Why if needed. Click Connect.
- A double-click on a node opens its note in the notes.
The page then says “Connection saved in Plan”. The connection appears as an arrow in the colour of its kind.
The toolbar
| Item | Meaning |
|---|---|
| Find a note, folder or #tag | search with a list of hits that unfolds; hits open their branches, and the bar reports for example “3 matches, 2 branches opened” |
| Status | Every status or one status, each with its count |
| Tag | Every tag or one tag, when the brain has tags |
| Product | All products or one product |
| Kinds of connection | menu with every kind, its colour and count; switches kinds on and off, the number on the button shows how many are on |
| Reset filters | clears all filters |
| New note | a note from the template of its type |
| Scaffold from code | have notes proposed from a project folder (Scaffold from the code) |
| Check brain | starts the Brain check |
| Read again | reads the brain anew |
| Side panel, Full screen | as in the Overview |
The mind map
- Move: drag the free area or move with two fingers; zoom with the mouse wheel or a pinch, or with Zoom in and Zoom out. Fit to view shows everything, Lay out again arranges the nodes anew.
- Branches: Unfold and Fold at a node with children.
- Moving a node: drag it; it stays where you put it until the layout changes.
- Changing a connection: a click on an arrow opens Edit connection, with Delete there too. Where several connections lie on top of each other, the click selects the node they start from.
Details of a node
| Item | Meaning |
|---|---|
| Note or Folder, type | what the node is; without a type it says no type |
| Open | opens the note |
| New note here | a new note that belongs to this node |
| Rename | dialog Rename „Plan“: “Every link to it in the brain is updated along.” |
| Fields | the fields in the YAML header |
| Required fields, Required sections | what the type asks for, each present or missing |
| Outgoing, Incoming | connections with kind and target, each with Edit and Delete; without a why it says Reason (warum) missing |
| Mentioned in the text | Mentions and Mentioned by: wikilinks in the text |
With no node selected, the side panel shows the number of Nodes, Connections and Missing targets and explains how to use the map.
New note
- Click New note, or New note here at a node.
- Enter Name, Folder (or Top level) and Type. Belongs to sets the connection upwards.
- Optional As a folder with its folder note: creates a folder with a note of the same name.
- The dialog shows which sections the note gets (“Gets the sections: …”).
- Click Create.
The note gets the YAML header and the required sections of its type.
In vaults with rules of their own
If the brain is not a WebDonkey brain but a vault with rules of its own (a Claudian brain or a personal Second Brain, say), the structure shows its links as connections, in the text and in the properties, and its folders as branches. Such a vault needs no type or status, and WebDonkey only writes there when you do something.
What happens in the background
WebDonkey writes connections, reasons and names into the YAML header of the note concerned; when renaming it updates every link in the brain (“Renamed: 4 links in 3 files updated”). For very large brains the map shows a part (“This brain is very large: the map shows part of it.”).
Free and Premium
The structure is 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.” | pick another name |
| “No note of this name yet: it shows as a missing target.” | a note in the connection dialog; create the note later |
| No notes in this brain yet | create a product with New note |
See also
Scaffold from the code Premium
Scaffold from the code reads the folder of a software project and proposes notes for a WebDonkey brain: pages, commands, services and data, ordered along the click path. That gives you a complete scaffold in a few minutes, which you or Claude then fill with descriptions. WebDonkey only reads the code and changes nothing there. Only what is missing in the brain is created.
Where to find it
Sidebar › Tools › Notes › Second Brain, Overview at a brain, tab Structure, in the toolbar Scaffold from code.
How to do it
- Click Scaffold from code. The dialog Scaffold from the code opens with the subtitle “Pages, commands, services and data of a project as notes”.
- Click Choose project folder and pick your project’s folder.
- WebDonkey reads the project (“Reading the project …”) and then shows the kind of project and the count, for example “Astro · 24 new, 3 already there”.
- Look through the list. Each entry shows name, type and code anchor, indented by its place on the click path. Entries that exist in the brain already show exists and are grey.
- Choose what to create. All missing entries are preselected. Select all and Select none help with long lists.
- Click Create (24). It then says “24 notes created” with the hint “Descriptions, law and prices are added afterwards by you or an AI.”
Other folder reads another project, Close ends the dialog.
What is recognised
| Kind of project | What is read |
|---|---|
| Tauri + React, Tauri | pages (from the routes or folders), backend commands, background services, storage places, data models |
| Astro | pages and endpoints from the file paths, data models |
| Shopware plugin, PHP (Symfony, Laravel, plain files) | pages, routes and admin modules, console commands, services and scheduled tasks, data models; for plugins the plugin configuration |
| Node.js (React Router, Next, SvelteKit, Nuxt, Express) | pages and endpoints, commands, services, data models |
For every kind of project, CI pipelines come in as services and SQL tables as data.
The scaffold is a tree: at the top the product as a folder note, below it the areas “Pages”, “Commands”, “Services” and “Data”, below those the single nodes. Pages nest along their addresses. Names start with the project name, so two projects in one brain never get in each other’s way.
Selection
- Untick an entry and every entry below it goes too.
- Tick an entry and the missing entries above it come along.
- Existing entries cannot be ticked: WebDonkey overwrites no note.
What happens in the background
- The project folder is only read. WebDonkey skips symbolic links, dependency, build and test folders. If the project is very large, it reads a part and says “The project is large: only part of it was read.”
- Whether an entry exists already, WebDonkey checks by name, across the whole vault and ignoring case, like Obsidian’s links.
- New notes get the template of their type,
typ,status: aktivandgehoert-zuin the YAML header, and the code anchor under the heading## Code-Anker. A node with children becomes a folder with a note of the same name. - Writing happens only inside the vault.
Free and Premium
The scaffold is Premium (“The scaffold is part of WebDonkey Premium.”).
Troubleshooting
| Message | What to do |
|---|---|
| “This folder cannot be read. Choose a project folder.” | pick a folder you can read |
| “Nothing found in this folder that the scaffold knows: no pages, commands, services or data.” | the kind of project is not recognised; create notes by hand |
| Unknown kind of project | WebDonkey does not recognise the layout; entries may still appear |
| “This brain is no longer there.” | the brain was removed or its folder is missing |
See also
Brain check Premium
The Brain check looks for gaps and errors in a brain: connections to notes that do not exist, links to missing headings, missing required fields and sections, unknown types and names used twice. Every finding names the note and the line, and a click shows the node on the mind map. Claude can run the same check itself in a session, through the brain tools.
Where to find it
Sidebar › Tools › Notes › Second Brain, Overview at a brain, tab Structure, in the toolbar Check brain.
How to do it
- Click Check brain.
- The side panel opens on the right with the Brain check tab. At the top is the count, for example “2 errors · 1 warnings · 0 hints”.
- Click a finding. The mind map shows the node concerned.
- The Open icon at the finding opens the note so you can fix the problem.
- Check again afterwards with Check brain.
If the check finds nothing, it says “No findings: the brain keeps its rules.” The cross at the top closes the list; the Details tab shows the selected node again.
The findings
The list is sorted: errors (red) first, then warnings (yellow), then hints. Each finding shows the rule, below it the path and line of the note and, where it fits, the value in question.
| Rule | Meaning |
|---|---|
| Connection to a note that does not exist | the target of a connection or link is missing |
| Link to a heading that does not exist | [[Note#Section]] points at a missing section |
| Note without a type, Note without a status | typ or status is missing in the YAML header |
| Unknown note type, Unknown kind of connection | the type or kind is not defined in the brain |
| Belongs to nothing (gehoert-zu is missing) | the note hangs on no parent node |
| Required connection missing | the type asks for a connection that is missing |
| Required section missing | the type asks for a heading that is missing |
| Required field missing | the type asks for a field in the YAML header that is missing (warning) |
| Connection without a reason (warum) | the kind of connection asks for a sentence why |
| Active node connected to one that is not active | for nodes with this status the brain asks for a connection that is missing |
| On hold: read it, do not build on it | an active node is connected, without a reason, to a node that is on hold |
| Code anchor no longer found | the place in the code named under the code anchor no longer exists |
| Name used twice | two notes carry the same name |
Missing required fields count as warnings, all other rules as errors.
In vaults with rules of their own
If the brain is not a WebDonkey brain but a vault with rules of its own, the Brain check only checks the links: Connection to a note that does not exist and Link to a heading that does not exist. It does not ask for type, status or required fields there.
The brain tools for Claude
When you start Claude in a WebDonkey brain or a personal Second Brain, it also gets a small MCP server called wd-brain with five tools that only read:
- search the brain,
- fetch a node, the note’s text only on request,
- follow a node’s click path upwards,
- follow its connections,
- check the brain, with the same rules as above.
That way Claude never loads the whole vault but fetches exactly what it needs. Because the tools only read, Claude may use them without asking. In vaults with rules of their own they work over wikilinks, folders and properties, and the check only runs when you ask for it. In Claudian brains Claude starts without these tools, exactly as in Claudian.
What happens in the background
The Brain check only reads the notes and writes nothing. The brain tools run as part of WebDonkey on your Mac, without network access, and write nothing either. When they start, they check whether Premium is active on this Mac.
Free and Premium
Brain check and brain tools are Premium. Without Premium the brain tools end right after starting, and Claude works without them.