nodeBook

obsidian-nodebook

An Obsidian plugin that renders ```nodeBook code fences as interactive CNL knowledge graphs — the Obsidian twin of logseq-nodebook, built on the same @nodebook/dom renderer.

```nodeBook
# Water [Substance]
boiling_point: 100 *C*;
<part of> Ocean;

## frozen
    state: solid;
```

Everything @nodebook/dom provides works here: draggable concept maps with inspector panel and morph switching, inferred relations with proof tooltips, containment (Nest) view, and Petri-net process notation with click-to-fire token simulation. The theme follows Obsidian's light/dark setting live.

Install (manual / development)

npm install
npm run build

Then copy the plugin into a vault and enable it:

mkdir -p "<YourVault>/.obsidian/plugins/nodebook"
cp dist/main.js dist/manifest.json "<YourVault>/.obsidian/plugins/nodebook/"

Obsidian → Settings → Community plugins → enable nodeBook (turn on community plugins if this vault hasn't yet).

How it works

registerMarkdownCodeBlockProcessor('nodeBook', …) hands each fence's source to renderNodeBook; a MarkdownRenderChild ties the Cytoscape instance's lifetime to the block so re-renders and closed panes clean up properly. Editing needs no special affordance: in Live Preview, click beside the block to flip it back to source.

Schemas: your own type system

nodeBook validates and infers against a type system you can extend three ways:

1. The schema store page — on first run the plugin creates the note nodebook/schemas.md seeded with the built-in (factory) schemas as an editable ```nodeBook-schema block. Edit or extend it: your version of a definition wins by name, and every open graph refreshes live.
2. Inline schema fences — any ```nodeBook-schema block renders as a summary panel and contributes its definitions while visible.
3. Per-graph links — start a nodeBook fence with schemas: [[Physics Types]], [[Chemistry Types]]; to merge those pages' schema fences over the store for that graph only (later pages win by name).

Schema syntax (full reference in the CNL specification):

```nodeBook-schema
nodeType: Planet, A celestial body orbiting a star, parent: Object
relationType: orbits, One body orbits another, domain: Planet, range: Star, inverse: is orbited by
attributeType: diameter, float, Size measurement, unit: km, domain: Planet
```

Learning the CNL

The public nodeBook tutorial walks through the whole language in 17 guided lessons — nodes, relations, attributes, morphs, inference, and process simulation — with live examples you can copy into any fence.

License

AGPL-3.0-only.