Get AI summaries of any video or article — Sign up free
Getting started with ExcaliBrain - starting from an empty Obsidian Vault (Part 2 of 3) thumbnail

Getting started with ExcaliBrain - starting from an empty Obsidian Vault (Part 2 of 3)

5 min read

Based on Zsolt's Visual Personal Knowledge Management's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Enable “show label on link” in base link styles so ontology types (like “position”) appear directly on connections.

Briefing

Excalibrain’s relationship graph becomes truly usable once link styling and ontology visibility are aligned—so the “remote work policy” node doesn’t just connect to other nodes, it clearly shows what those connections mean. The session starts by revisiting Excalibrain’s ontology and link styling settings, then turns on label and arrow display so the graph communicates direction and relationship type at a glance. A key fix is changing the base link style so ontology information (like the “position” type added earlier) appears on the links, and adjusting arrowheads to reduce confusion about which side is the start versus the end.

Arrow direction is handled through two approaches: Excalibrain can use an inverse arrow direction by default, or users can keep that logic and instead switch which arrowhead is set to an arrow. In practice, the “remote work policy” node ends up with arrows pointing toward the two connected nodes that represent positions, with the direction tuned to match the user’s internal reading order. The session also highlights a practical navigation feature: embedded mode. When embedded mode is enabled, the connector between the leaf note view and the Excalibrain view disconnects; turning embedded mode off reconnects it. A separate “synchronize navigation” toggle in Excalibrain behavior settings controls whether the two navigation controls act together or independently.

The workflow then shifts to managing embedded nodes and theme consistency. The “remote work policy” node is selected, embedded mode is turned on, and the user observes how the connector behavior changes. Next comes a styling issue: embedded markdown nodes follow the Excalidraw theme by default. In light mode, embedded nodes look correct; switching to dark mode without matching settings can produce ugly colors. The fix is found in Excalidraw settings—specifically the option “markdown embeds to match excalidraw theme.” After toggling that setting, the user may need to close and reopen Excalibrain for the change to apply.

With the graph readable and the interface stable, the session builds the argument structure. The supporting argument relationship is added to the ontology using Excalibrain’s “add data view field to ontology” command (via the command palette). After the ontology updates, “supporting argument as an ontology” appears on the relevant link, and a new markdown document is created as a supporting argument node. That document is formatted as an argument with an “argument” tag and a question: “how can remote work improve employee work life balance?” The question itself is then added to the ontology as a “next” friend type so it appears on the right side of the graph.

Finally, the session polishes the visual semantics. Supporting argument links are reformatted to be green and thicker (set to 3px), while objecting arguments are intended to be red (set up as the desired color scheme). The result is a graph where “remote work policy” connects to a clearly labeled supporting argument, which contains a question node about work-life balance. The session closes by previewing the next step: adding evidence, including web links, and embedding those links into the graph with further formatting and settings in Part 3.

Cornell Notes

The session focuses on making Excalibrain graphs readable by ensuring ontology types appear on links and by tuning link styling and arrow direction. It walks through enabling link labels and arrowheads in base link styles so relationships like “position” are visible directly on the connections. It also covers embedded mode behavior and a common theme mismatch: embedded markdown nodes follow the Excalidraw theme unless “markdown embeds to match excalidraw theme” is configured. Finally, it builds an argument chain by adding “supporting argument” and “question” to the ontology, creating a supporting-argument markdown node with an argument tag, and formatting supporting links as thick green arrows.

How does Excalibrain make ontology meaning visible on connections rather than leaving it implicit?

Ontology meaning becomes visible by changing link styling so link labels are shown. In settings, the base link style is edited to enable “show label on link.” The ontology type added earlier (like “position” as a next friend type) then appears on the link itself once labels are enabled.

Why can arrow direction feel confusing, and what are the two ways to correct it?

Arrow direction can be confusing because Excalibrain may use an inverse arrow direction by default, changing which side is treated as the start versus end. Users can either turn off inverse arrow direction (which flips the arrows automatically) or keep the inverse logic and instead set the “end Arrowhead” to an arrow rather than the “start Arrowhead.” Both approaches can produce the same visual result for the “remote work policy” connections.

What changes when embedded mode is turned on, and how can navigation synchronization be controlled?

Turning on embedded mode disconnects the connector between the leaf note view and the Excalibrain view. Turning embedded mode off reconnects it. Separately, Excalibrain behavior settings include a “synchronize navigation” toggle; when enabled, navigation actions in one view mirror the other, and when disabled, the two navigation controls operate independently.

Why might embedded markdown nodes look wrong in dark mode, and how is that fixed?

Embedded markdown nodes follow the Excalidraw theme by default. If dark mode is enabled but embedded nodes aren’t matching the theme, colors can look ugly. The fix is in Excalidraw settings: enable “markdown embeds to match excalidraw theme.” After changing this, Excalibrain may need to be closed and reopened for the update to take effect.

What is the process for adding a supporting argument type and then creating a supporting argument node?

First, “supporting argument” is added to the ontology using the command palette option “add data view field to ontology” (selecting the supporting argument as the next friend type). After the ontology updates, a supporting argument node is created by holding Shift and clicking the supporting-argument link. The new markdown document is created with an argument tag and a question prompt (e.g., “how can remote work improve employee work life balance?”).

How are supporting argument links visually distinguished from other relationship types?

Link styling is customized per relationship type. In Excalibrain settings, the “supporting argument” relationship type is selected, then its line color is set to green and its thickness is increased (set to 3px). This makes supporting links stand out clearly in the graph.

Review Questions

  1. What specific settings changes ensure ontology labels appear on links, and where are those settings located?
  2. How can a user achieve the desired arrow direction if Excalibrain’s default inverse arrow direction feels backwards?
  3. What steps are required to add a supporting argument and a question node to the ontology, and how does the created markdown document reflect that structure?

Key Points

  1. 1

    Enable “show label on link” in base link styles so ontology types (like “position”) appear directly on connections.

  2. 2

    Use either inverse arrow direction toggling or switch which arrowhead is set to an arrow to match the graph’s direction with the user’s reading logic.

  3. 3

    Embedded mode disconnects the leaf-to-Excalibrain connector; navigation mirroring is controlled separately via the “synchronize navigation” behavior toggle.

  4. 4

    Embedded markdown nodes follow the Excalidraw theme by default; dark-mode mismatches are fixed by enabling “markdown embeds to match excalidraw theme,” sometimes requiring a restart of Excalibrain.

  5. 5

    Add “supporting argument” and “question” to the ontology via the command palette so new nodes automatically appear in the correct graph positions.

  6. 6

    Create supporting-argument markdown nodes using the Shift-click workflow and include an argument tag plus the question text.

  7. 7

    Customize relationship styling per link type—such as thick green supporting-argument arrows—to make argument structure visually scannable.

Highlights

Turning on link labels makes ontology meaning visible on every relationship line, not just in settings.
Arrow direction can be corrected either by flipping inverse arrow direction or by moving the arrowhead setting from start to end.
Embedded mode changes connector behavior between views, while “synchronize navigation” controls whether navigation actions mirror each other.
Embedded markdown theme issues in dark mode are typically resolved by matching embedded markdown to the Excalidraw theme setting.
Supporting arguments become a structured argument node when “supporting argument” and “question” are added to the ontology and the markdown includes an argument tag.

Topics

  • Ontology Visibility
  • Link Styling
  • Arrow Direction
  • Embedded Mode
  • Argument Graph Setup