← All help

Working with Obsidian

Open an Obsidian vault in Filamental as it is, or open a Filamental project in Obsidian as it is. Either direction works, and opening a folder in one app never locks it against the other.

Where: Projects (click your project's name, top left) › Start Something… › Use What You Have › Obsidian

What it is

Filamental and Obsidian can point at the exact same folder, because both keep notes as plain Markdown. This is separate from the Obsidian Plugin: that's a view inside Obsidian, and this is two apps sharing one folder of real files.

How to use it

Import from Obsidian

  1. Click Start Something… and choose Obsidian, under Use What You Have.
  2. Pick your vault's folder, then click Analyse folder. The scan only reads, and shows how many notes and wikilinks it found, and how many links point at notes that don't exist.
  3. Click Next and choose what to Classify notes by: the vault's sub-folders, a property your notes already carry (such as type or category), or nothing for now. Switch on Add my own classifications to name some yourself.
  4. Click Start import. The report lists the notes imported, the connections made and any Unresolved links, then Open folder takes you in.

Each note gets Filamental's details added to its front matter, and every field it already has (tags, aliases and the rest) is kept. The text of your notes and your folders stay exactly as they are.

Opening a vault as a folder

Choose Folder (or Open) and pick a vault, and Filamental asks This looks like an Obsidian folder:

  • Add Classifications goes straight to choosing classifications, as above.
  • Clean Import imports with no classifications.
  • Open as it is skips the import, and Filamental remembers that answer for this folder. The vault opens read-only and nothing is written into your notes, so only notes that already carry Filamental's details appear. Click Add to shortcuts and edit to bring the rest in.

When wikilinks become connectors

It happens once per note, when Filamental first takes that note in, and never again after that. A [[Note Name]] you type later stays a link in the text, not a connector, and Obsidian never turns anything into connectors.

All three routes take notes in the same way, so wikilinks connect whichever you choose. The import adds the counts, the classifications and the list of links that point at notes that don't exist.

The connectors arrive untyped on purpose, as Universal. Filamental can't know whether one note supersedes another, contradicts it, or just mentions it, and guessing would be worse than leaving that to you. Run it once, then type the connectors that matter.

Tips

  • Works best on a moderate-sized vault. A huge tangle of links will naturally "ball up" once it's all sitting in Filamental's physics, so a very large or densely cross-linked vault is worth importing in stages, or just left readable side by side.
  • Notes already imported are skipped, so it's safe to run the import again after adding notes in Obsidian.
  • Opened as it is, a note whose front matter is broken is left exactly as it is, and doesn't appear until you fix it. Fix any you know about before you import.

How this helps you

The workflow this suits: plan and build a project in Filamental while it's still moving, then archive it into Obsidian once it's settled.

Filamental is where a structure is still being worked out: the 3D layout, AI reading and writing it live, connectors you haven't fixed the shape of yet. Once it's finished, dropping it into your Obsidian vault folds it into the library you already keep there.

Nothing forces the move. Leave a project in Filamental as long as you like, or read the same folder in both apps side by side for as long as that's useful. Which folder to point an AI at, the moving one or the archive, is covered in Folder Access.

Related

Still stuck? Email [email protected].