Skip to main content

Neo4j Graph View

Documentation at https://publish.obsidian.md/semantic-obsidian/Neo4j+Graph+View+Plugin. Join the new Discord server to discuss the plugin: https://discord.gg/sAmSGpaPgM

Adds a new and much more functional graph view to Obsidian. It does so by connecting to a Neo4j database. Features:

  • Selectively style nodes and edges by tags, folders and link types
  • Selective expansion and hiding of nodes
  • View images within the graph
  • Cypher querying
  • Typed links using - linkType [[note 1]], [[note 2|alias]]
  • Hierarchical layout

Installation

Detailed installation instructions is at https://publish.obsidian.md/semantic-obsidian/Installation+of+Neo4j+Graph+View+Plugin

  1. Make sure you have Python 3.6+ installed. It needs the system-installed Python. Make sure to add Python to PATH!
  2. Make sure you have Neo4j desktop installed
  3. Create a new database in Neo4j desktop and start it. Record the password you use!
  4. In the settings of the plugin, enter the password. Then run the restart command.

Use

Detailed getting started guide is at https://publish.obsidian.md/semantic-obsidian/Using+the+Neo4j+Graph+View

On an open note, use the command "Neo4j Graph View: Open local graph of note". You can run commands using ctrl/cmd+p. Alternatively, you can bind this command to a hotkey in the settings.

The settings contains several options, such as coloring based on folders and a hierarchical layout.

Cypher Querying

Create code blocks with language cypher. In this code block, create your Cypher query. Then, when the cursor is on this code block, use the Obsidian command 'Neo4j Graph View: Execute Cypher query'. Example:

Possible problems

All changes made in obsidian should be automatically reflected in Neo4j, but this is still very buggy.

If you are running into issues, see https://publish.obsidian.md/semantic-obsidian/Installation+of+Neo4j+Graph+View+Plugin#troubleshooting

Semantics

The plugin collects all notes with extension .md in the input directory (default: markdown/). Each note is interpreted as follows:

  • Interprets tags as entity types
  • Interprets YAML frontmatter as entity properties
  • Interprets wikilinks as links with type inline, and adds content
  • Lines of the format "- linkType [[note 1]], [[note 2|alias]]" creates links with type linkType from the current note to note 1 and note 2.
  • The name of the note is stored in the property name
  • The content of the note (everything except YAML frontmatter and typed links) is stored in the property content
  • Links to notes that do not exist yet are created without any types.

Other visualization and querying options

Another use case for this plugin is to use your Obsidian vault in one of the many apps in the Neo4j desktop Graph Apps Store. Using with this plugin active will automatically connect it to your vault. Here are some suggestions:

Neo4j Bloom

Neo4j bloom is very powerful graph visualization software. Compared to the embedded graph view in Obsidian, it offers much more freedom in customization.

GraphXR

GraphXR is a 3D graph view, which looks quite gorgeous!

Neo4j Browser

A query browser that uses the Cypher language to query your vault. Can be used for advanced queries or data anlysis of your vault.

Python code: Semantic Markdown to Neo4j

This Obsidian plugin uses the Python package semantic-markdown-converter, which is also in this repo. It creates an active data stream from a folder of Markdown notes to a Neo4j database. For documentation, see https://publish.obsidian.md/semantic-obsidian/Semantic+Markdown+Converter

Release files for semantic-markdown-converter 0.5.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for semantic-markdown-converter 0.5.9
File Size Uploaded
semantic-markdown-converter-0.5.9.tar.gz 12.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for semantic-markdown-converter 0.5.9
File Interpreter ABI Platform
semantic_markdown_converter-0.5.9-py3-none-any.whl Python 3 none any Details

Total release size: 32.0 kB

Release files / semantic-markdown-converter-0.5.9.tar.gz

Download URL semantic-markdown-converter-0.5.9.tar.gz
Size 12.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f8ddc09d62b6d2ecc4e7934e59d52855fd3f439ec59066d677e32d09fbf814c2
BLAKE2b-256 checksum
How to use checksums
76792f13133b80108834880e9918879d1e1452c7b4b7831c2dbb897dd375bd2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/51.0.0 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.8.5

Release files / semantic_markdown_converter-0.5.9-py3-none-any.whl

Download URL semantic_markdown_converter-0.5.9-py3-none-any.whl
Size 19.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
20b8404449c0b46f26beb54d6cab6b9aa860c1d558f7f37b2730db66b601ce5a
BLAKE2b-256 checksum
How to use checksums
e86685b6ce001294dc68c21fbc89e982100a06878e63a620d2f8942193f97bf2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/51.0.0 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.8.5

Release history Release notifications | RSS feed

This release

0.5.9 This release

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page