robertmartin8/MolecularNotes

logo

This repository contains my Obsidian implementation of Molecular Notes – a Second Brain system that I use to organise my thinking. You can read about the philosophy of Molecular Notes here and more about the Obsidian implementation here).

Note: I am not accepting PRs as this repo represents my personal workflow. However, if you have a use case that the current iteration of MolecularNotes doesn't address, it would be awesome if you could create an issue and share the modification you made so that others can get some inspiration!

Basic setup instructions

Install Obsidian and create an Obsidian Vault (a folder to store all your notes). Mine is named ObsidianVault and I put it in my home folder.
Clone this repository into your vault (on GitHub click the green Code button, then Download ZIP, and copy-paste the contents into your vault using Finder or File explorer)
Delete the README.md file.
In Obsidian, go to Settings -> Files & Links -> Default location for new attachments -> _attachments (make this folder if it doesn't exist).
Set up templates:
1. Settings -> Core plugins -> Templates (switch on).
2. Settings -> Templates -> Template folder location -> _templates.
3. (Optional) set hotkey in Settings -> Hotkeys -> Templates: Insert Template -> ⌘T
Check you have the below plugins enabled: Settings -> Core Plugins
(Optional) Change the colour theme to something you like! You can find this in Settings -> Appearance -> Themes

Plugins

These are the core plugins I am using (most are enabled by default):

File explorer: duh
Search: duh
Quick switcher: a very useful way of quickly jumping to a new note: you just press ⌘O then start typing the note name to jump to it.
Graph view: duh
Backlinks / Outgoing links: duh
Tag pane: a helpful way of looking at your tags
Page preview: nice syntax
Templates: a must
Note composer: I have this but I've only used it rarely
Command palette: a must
Starred: a new-ish plugin that helps you save common searches
Markdown format importer: useful in my workflows to paste Notion content into Obsidian
Word count: up to you
Workspaces: handy! I've saved a note view and a graph view.
Sync: optional but I like it

Community plugins:

Mind Map: occasionally useful to visualise notes as a mindmap
Obsidian git: I like having an extra backup to a private github
Tag wrangler: very useful extension for renaming tags

Advanced setup

Make sure you have python 3 installed on your system. The helper script can be run from your Obsidian Vault:

cd ObsidianVault && python _scripts/obsidian_util.py

In my ~/.zshrc I then created an alias for this, such that when I type obsidian into terminal my script runs.

alias obsidian="cd $HOME/ObsidianVault && python _scripts/obsidian_util.py"

Polymer dashboard

The Polymer dashboard (a spaced repetition tool) requires streamlit to be installed (pip install streamlit). It can be run using:

cd ObsidianVault && streamlit run _scripts/polymer.py

If you are having trouble with Polymer, please follow the below steps:

Shut down the dashboard (e.g ctrl-C wherever you ran streamlit run _scripts/polymer.py)
Delete the _scripts/db.json file. Note: this will delete your current flashcard progress
Re-run the dashboard

GPT embeddings

See this blog post for more information.

_scripts/gpt_search.py implements a smart search. To get it working:

Install the dependencies: pip install openai tiktoken tenacity click tabulate.
Put in your OpenAI key at the top of the file.
Open terminal and create an alias. My tool is called nmr but you can call it something else.

alias nmr="cd $HOME/ObsidianVault && python _scripts/gpt_search.py"

Organising my Second Brain

The ideas behind this are discussed in the blog posts, but here is a reference.

Folders

Underscore folders represent Obsidian internals
Topics stores Topic types for faster browsing
Sources contains my notes on any information media: books, articles, videos etc
Molecules contains my personal observations/ideas/thoughts
Authors are Source note authors.
Atoms go in the top level