Soaffine Obsidian Vault

Features

Zotero Compatibility

Easily import Zotero items to your Obsidian vault.

Automatically generate Zettelkasten literature notes and Pandoc references.

Pandoc references in permanent notes helpfully automatically find the literature note.

Automatic Reading Lists

Automatically keep track of reading progress, with a list of items from literature notes

Typst Compilation

Full typst support, generates embedded PNGs and SVGs from typst codeblocks instantly.

Text version of the code example.

= Fibonacci sequence
The Fibonacci sequence is defined through the
recurrence relation $F_n = F_(n-1) + F_(n-2)$.
It can also be expressed in _closed form:_

$ F_n = round(1 / sqrt(5) phi.alt^n), quad
  phi.alt = (1 + sqrt(5)) / 2 $

#let count = 8
#let nums = range(1, count + 1)
#let fib(n) = (
  if n <= 2 { 1 }
  else { fib(n - 1) + fib(n - 2) }
)

The first #count numbers of the sequence are:

#align(center, table(
  columns: count,
  ..nums.map(n => $F_#n$),
  ..nums.map(n => str(fib(n))),
))

More

• Integrate with Omnivore
• Talk to notes with OpenRouter, Anthropic, or OpenAI
• Encrypt Notes
• Custom Callouts
• Embeddable Charts
• Manage with Kanban
• Make Drawings
• Automatic Table of Contents
• Query data, lint markdown, replace typographical characters, set reminders, manage tasks, refactor notes, automatically pull link metadata, set banners, set icons

Pre-requisites

1. Overlay NUR onto nixpkgs, and allow unfree packages

Overlay:

inputs = {
  nixos-unstable = {
    url = "github:NixOS/nixpkgs/nixos-unstable";
  };
  nixpkgs.follows = "nixos-unstable";
  nur.url = "github:nix-community/NUR";
};

...
(import inputs.nixpkgs {
  inherit system;
  config.allowUnfree = true;
  overlays = [ inputs.nur.overlay ];
})
...

2. Install Obsidian

Install with home-manager:

{
  pkgs,
  ...
}:
{
  home.packages = builtins.attrValues { inherit (pkgs) obsidian obsidian-export; };
}

3. Install Zotero

Install with home-manager:

{
  pkgs,
  ...
}:
{
  home.packages = builtins.attrValues { inherit (pkgs) zotero; };
}

4. Install Zotero-Connector in Firefox

Install with home-manager:

{
  pkgs,
  ...
}:
{
  programs = {
    firefox = {
      enable = true;
      profiles = {
        default = {
          id = 0;
          extensions = builtins.attrValues {
            inherit (pkgs.nur.repos.rycee.firefox-addons)
              zotero-connector
              ;
          };
        };
      };
    };
  };
}

5. Install Better BibTeX for Zotero

This needs to be done manually currently.

Once installed, consider changing the generated citation key formula.

Change settings in Zotero:

I recommend setting the "Citation key formula" to (Title || auth) + year.

Useful Commands

• Ctrl+P > Zotero Integration: Create Literature Note - If Zotero is open, will provide a selector. Selected library item will add a note to 05 - Literature
• Ctrl+P > Zotero Integration: Pandoc - If Zotero is open, will provide a selector. Selected library item will add a Pandoc citation similar to [@AttentionIsAllYouNeed2023]
• Ctrl+P > Banner: Paste banner from clipboard - If the clipboard contains an image link, will add as a banner to the top of the note.