Vithanco for Obsidian

Render Vithanco diagrams directly inside your notes — IBIS, Concept Maps, Decision Trees, Goal Trees, Causal Loop Diagrams, and more — using a simple vgl code block.

Vithanco = Visual Thinking and Communication. VGL (Vithanco Graph Language) is a compact text format for these diagrams.

Example

```vgl
vgraph decision: IBIS "Should we ship the plugin?" {
  node q1: Question "Should we ship?";
  node a1: Answer "Yes, soon";
  node p1: Pro "Users have asked for it";
  node c1: Con "Docs are still thin";
  edge q1 -> a1;
  edge a1 -> p1;
  edge a1 -> c1;
}
```

The block is replaced with a rendered SVG in reading view.

Supported notations

IBIS, BBS, Impact Mapping, Concept Map, Current Reality Tree (CRT), Evaporating Cloud (EC), Future Reality Tree (FRT), Prerequisite Tree (PRT), Transition Tree (TRT), Attack-Defense Tree, Goal Tree, Causal Loop Diagram (CLD), Decision Tree, Timeline.

Learn the language

• VGL Syntax Guide — full reference for the language
• Notations Gallery — examples and use cases for every supported notation

You can also open these from inside Obsidian: open the command palette and search for Vithanco: Open VGL syntax guide or Vithanco: Insert IBIS example. There's a settings tab with the same links under Settings → Community Plugins → Vithanco.

Installation

From the Community Plugins browser (once approved)

1. Open Obsidian → Settings → Community Plugins → Browse
2. Search for Vithanco
3. Install and enable

Manual installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Copy them to <your-vault>/.obsidian/plugins/vithanco/
3. Reload Obsidian and enable the plugin

Requirements

• Obsidian 1.4.0 or newer
• Desktop only (mobile support planned)
• Internet on first launch — the Graphviz layout engine (@hpcc-js/wasm) is loaded from the jsDelivr CDN to compute diagram layouts, then cached by Electron. No other network calls are made; the plugin does not read or write files outside your vault.

How it works

The Vithanco rendering engine is compiled from Swift to WebAssembly and embedded in the plugin. When you open a note containing a vgl code block, the plugin:

1. Parses the VGL source
2. Computes layout via Graphviz (loaded once from jsDelivr)
3. Produces a styled SVG
4. Injects it into the rendered Markdown

Support

If you find this useful, please consider sponsoring on GitHub. The plugin will always be free and open source.

Links

• Vithanco website (notations gallery): https://vithanco.com
• VGL syntax guide: https://vithanco.com/tools/VGL_GUIDE/index.html
• VGraph monorepo (Swift source, MCP server, CLI): https://github.com/Vithanco/VGraph
• Issues: https://github.com/Vithanco/obsidian-vithanco/issues

Acknowledgements

• Graphviz — layout engine, via @hpcc-js/wasm (Apache-2.0), loaded from jsDelivr at runtime
• @bjorn3/browser_wasi_shim (MIT/Apache-2.0) — bundled to run the Vithanco WebAssembly engine

License

MIT — see LICENSE.