diff --git a/copy_dotfiles.sh b/copy_dotfiles.sh
index e366166..166f967 100755
--- a/copy_dotfiles.sh
+++ b/copy_dotfiles.sh
@@ -42,6 +42,11 @@ copy_dir src_files/.config $XDG_CONFIG_HOME
 copy_dir src_files/.local/bin $DIR_BIN
 copy_dir src_files/.local/scripts $DIR_SCRIPTS
 
+for obs_dir in "${OBSIDIAN_WORKSPACES_TO_CONFIGURE[@]}"; do
+    [[ ! -d "$obs_dir/.obsidian" ]] && mkdir "$obs_dir/.obsidian"
+    copy_dir $XDG_CONFIG_HOME/obsidian "$obs_dir/.obsidian"
+done
+
 [[ "$BOX_SETUP_OS" = "macos" ]] && {
     copy_dir src_files/executable_wrappers_macos $DIR_BIN
     link_dir "$XDG_CONFIG_HOME/GIMP" "$HOME/Library/Application Support/GIMP"
diff --git a/ref/workflow-and-workspaces-scheme.md b/ref/workflow-and-workspaces-scheme.md
index ee14eec..94ce1ed 100644
--- a/ref/workflow-and-workspaces-scheme.md
+++ b/ref/workflow-and-workspaces-scheme.md
@@ -28,7 +28,7 @@ idea from the ThePrimeagen: designated workspace/label/desktop per app/purpose
     - for me, using peripherals with right hand, so put programs likely to be used with
       peripherals where my left hand can switch to them single-handedly (screens 1 to 5)
 
-## workflow/use notes
+## workflow / use notes
 
 - related to the layout above, my approach is to run almost every window in fullscreen
     - note: on macOS, this is not mac's notion of fullscreen, which basically moves
@@ -38,18 +38,22 @@ idea from the ThePrimeagen: designated workspace/label/desktop per app/purpose
 - key bindings are set for moving window focus up/down (vim style: mod + k/j)
     - the mental model here is that every fullscreen window is in a stack, so i can move
       focus up and down the stack
-- for any app which can have tabs, pair the above mental model of a stack with a mental
-  model of a circular-linked list being in any position in that stack
+- for apps with tabs, pair the above mental model of a stack with a mental model of a
+  circular list being in any position in that stack
     - so, keybindings are also set for previous/next tab (vim style: mod + h/l)
+    - specifically, mod+h is mapped to ctrl+shift+tab and mod+l is mapped to ctrl+tab,
+      so it should work anywhere ctrl+tab and ctrl+shift+tab work
 - all this said, it is better to keep things simple when possible and avoid having too
   many windows and/or tabs open at one time; however, with the designated purpose for
   each workspace and the mental models above, it rarely takes me long to find what i need
-    - examples:
-        - if i want a particular browser window, i jump to workspace 9, then move focus
-          up or down until i get to the window i want; if the window is right but i need
-          a different tab, i then just move "right or left" through my tabs
-        - if i want a particular music-playing app/tui, i jumpt to workspace 4 and move
-          focus up or down as needed to find it
-        - exception case: if i want a particular terminal workspace, i jump to workspace
-          8, but then i'm in tmux land and navigate via the methods i've set up for tmux
+
+## examples cases
+
+- if i want a particular browser window, i jump to workspace 9, then move focus
+  up or down until i get to the window i want; if the window is right but i need
+  a different tab, i then just move "right or left" through my tabs
+- if i want a particular music-playing app/tui, i jumpt to workspace 4 and move
+  focus up or down as needed to find it
+- variation case: if i want a particular terminal workspace, i jump to workspace
+  8, but then i'm in tmux land and navigate via the methods i've set up for tmux
 
diff --git a/src_files/.config/obsidian/app.json b/src_files/.config/obsidian/app.json
new file mode 100644
index 0000000..737b6b2
--- /dev/null
+++ b/src_files/.config/obsidian/app.json
@@ -0,0 +1,17 @@
+{
+  "defaultViewMode": "preview",
+  "showLineNumber": true,
+  "spellcheck": false,
+  "autoPairBrackets": false,
+  "autoPairMarkdown": false,
+  "useTab": false,
+  "autoConvertHtml": false,
+  "vimMode": true,
+  "trashOption": "none",
+  "newFileLocation": "folder",
+  "newFileFolderPath": "inbox",
+  "showUnsupportedFiles": true,
+  "attachmentFolderPath": "inbox",
+  "showInlineTitle": false,
+  "readableLineLength": false
+}
\ No newline at end of file
diff --git a/src_files/.config/obsidian/appearance.json b/src_files/.config/obsidian/appearance.json
new file mode 100644
index 0000000..4be83d6
--- /dev/null
+++ b/src_files/.config/obsidian/appearance.json
@@ -0,0 +1,4 @@
+{
+  "theme": "obsidian",
+  "accentColor": "#2f930e"
+}
\ No newline at end of file
diff --git a/src_files/.config/obsidian/core-plugins.json b/src_files/.config/obsidian/core-plugins.json
new file mode 100644
index 0000000..d0803c1
--- /dev/null
+++ b/src_files/.config/obsidian/core-plugins.json
@@ -0,0 +1,33 @@
+{
+  "file-explorer": true,
+  "global-search": true,
+  "switcher": true,
+  "graph": true,
+  "backlink": true,
+  "canvas": true,
+  "outgoing-link": true,
+  "tag-pane": true,
+  "footnotes": false,
+  "properties": false,
+  "page-preview": true,
+  "daily-notes": true,
+  "templates": true,
+  "note-composer": true,
+  "command-palette": true,
+  "slash-command": false,
+  "editor-status": true,
+  "bookmarks": true,
+  "markdown-importer": false,
+  "zk-prefixer": false,
+  "random-note": false,
+  "outline": true,
+  "word-count": true,
+  "slides": false,
+  "audio-recorder": false,
+  "workspaces": false,
+  "file-recovery": true,
+  "publish": false,
+  "sync": false,
+  "bases": true,
+  "webviewer": false
+}
\ No newline at end of file
diff --git a/src_files/.config/obsidian/hotkeys.json b/src_files/.config/obsidian/hotkeys.json
new file mode 100644
index 0000000..f78d228
--- /dev/null
+++ b/src_files/.config/obsidian/hotkeys.json
@@ -0,0 +1,16 @@
+{
+  "markdown:toggle-preview": [
+    {
+      "modifiers": [
+        "Mod"
+      ],
+      "key": "E"
+    },
+    {
+      "modifiers": [
+        "Alt"
+      ],
+      "key": "R"
+    }
+  ]
+}
\ No newline at end of file
diff --git a/src_files/.config/zsh/.zshenv b/src_files/.config/zsh/.zshenv
index e8241e9..acaf190 100644
--- a/src_files/.config/zsh/.zshenv
+++ b/src_files/.config/zsh/.zshenv
@@ -31,6 +31,9 @@ export ZDOTDIR="$XDG_CONFIG_HOME/zsh" # may already be set, set anyway
 # git
 export GIT_EDITOR="$EDITOR"
 
+# obsidian
+export OBSIDIAN_WORKSPACES_TO_CONFIGURE=("$DIR_NOTES")
+
 # clean-up of home dir
 export __CF_USER_TEXT_ENCODING="0x0:0x0"