Logo

Bring your vault

Import your Obsidian vault into your D&D campaign

Drop in a .zip of your vault and it becomes a real campaign: your folders become sections, your notes keep the structure you wrote, your secrets stay DM-only, and the SRD copy you never wrote is left out. It is free, it uses no AI, and nothing you wrote is rewritten.

If you have run a campaign for years, you already did the work. You should not have to type it twice, and you certainly should not have to read it aloud into a microphone.

What comes across

Import is a structural conversion, not an interpretation. We do not summarise your prose, reword your notes, or decide what your world means. We move it.

  • Your folders become sections

    An NPCs folder becomes an NPCs section with your NPCs inside it. The shape you built stays the shape you get, nested as deep as you had it, and zipping the vault folder does not add an extra layer on top.

  • Your formatting stays yours

    Headings, bullet and numbered lists, tables, quotes and callouts all carry across. Code blocks (including statblock and dataview fences) are preserved exactly, not reinterpreted.

  • Wikilinks are kept and matched

    Every [[link]] survives in your text, and we tell you how many matched a page you imported. The ones that matched nothing are the entities you clearly care about but never wrote up.

  • Secrets stay secret

    Anything in a Secrets or DM Info folder imports as DM-only. So does any note carrying a [!secret] callout, a "DM Only" heading, a %%comment%% that mentions a secret, or secret: true in its frontmatter. Obsidian %%comments%% never show up in the imported text. We hide first and let you reveal, never the other way round.

  • Rulebook copies are left out

    Most vaults carry an SRD or compendium dump the DM never wrote. We detect it and leave it out so your notes tree is not flooded with Goblin and Fireball, and we list everything excluded so nothing vanishes quietly.

How to prep your import

Four steps, and only one of them is worth real effort.

  1. Export the whole vault as a .zip

    In Obsidian, zip your vault folder, including its hidden .obsidian folder: that is how we recognise your daily notes. You do not need to tidy it first, and you do not need to delete your SRD copy: we handle both. A single .md or .txt file works too if you only want to bring one thing across.

  2. Check your secret folders are named like secrets

    Folders called Secrets, DM Info, DM Notes, GM Notes, Spoilers or Behind the Screen are recognised automatically. If yours is called something else, rename it before exporting, move those notes under one that is, or add secret: true to their frontmatter. This is the one thing worth two minutes of your time.

  3. Name session logs so we can spot them

    A file tagged as a session in its frontmatter, named like one (Session 12.md, S12.md), or kept inside a Sessions folder is listed as a session log. A file named with only a date (2026-03-14.md) is listed too, but left unticked, and Obsidian daily notes are left out. You then pick which logs become real sessions, not just notes.

  4. Open Import notes and check the preview

    Open Import notes from Notes, Add Session, or Scribe chat, then pick or drop your .zip. Choose to save your notes, draft a campaign overview, or build campaign records. Before the files are saved, the preview shows what will be imported, what will be hidden from players, and what is being left out and why.

Your session logs can become real sessions

If you keep written session logs, they do not have to arrive as just another note. During the import, tick Also turn session logs into sessions and you get a list of the logs we found. Clear session logs are ticked for you, ones we are less sure about are left unticked, and you decide exactly which become sessions, with their text as the transcript. You can also paste a log straight in without importing anything, which is the fastest way to try this.

Logs in a DM-only folder never become sessions, because a session is visible to every player. They arrive as DM-only notes instead.

Creating these sessions is free. Open a session to review its processing price and choose a Scribe tier when you want a summary, timeline and quotes. Imported sessions wait until you ask to process them.

Writing notes in brackets like [DM: he is lying]? Recognized DM asides are moved into the session's private notes. Review the transcript before processing to make sure it contains only what your players should see.

How session processing works

What it does not do yet

We would rather you knew before you uploaded than after.

  • Images inside your vault are skipped for now, so notes that embed a picture arrive without it.
  • Wikilinks stay as text rather than becoming clickable links between notes.
  • Re-importing updates notes you changed and skips the rest, but notes you deleted from your vault are not removed from the campaign.
  • .docx and PDF files are not read yet. Markdown and plain text only.

Choose Build campaign records and tick the types to extract, including NPCs, locations, quests, factions, items, creatures and scenes. Events, relationships, maps and sheets start as private drafts. Review the Silver quote before analysis, then choose which records or drafts to save. Your original notes stay intact, with source links in the results.

Questions

Does importing change anything in my Obsidian vault?

No. You upload a copy, and we only ever read it. Your vault on disk is untouched, and you can keep working in Obsidian exactly as before.

Does it cost anything?

Saving the source notes is free and uses no AI. For an overview or structured import, pick Goblin, Human or Elven Scribe and review the Silver estimate and maximum charge. The price covers text read and generated output, with no per-record fee; selecting more entity types can change the quote. Completed analysis is charged even if you decline its proposed changes; applying reviewed changes is free. Text sessions are created free and have their own price review before session processing.

I have the whole 5e SRD in my vault. Will that get imported?

No. Compendium and SRD-shaped content is detected and excluded by default, using folder names, statblock frontmatter, and the tell-tale shape of a folder full of near-identical generated files. Everything excluded is listed with a reason on the summary, so if we got it wrong you will see it rather than discover it later.

What happens to my DM-only notes?

Notes from a Secrets or DM Info folder import as DM-only, and so does any note containing an inline secret marker such as an Obsidian [!secret] callout or a "DM Only" heading, or secret frontmatter such as secret: true. A folder only becomes DM-only when everything inside it is, so one secret note never hides a whole public section. When a note is marked secret we hide the whole note rather than part of it, because an over-hidden note takes one click to reveal while a spoiler a player has already read cannot be taken back. Session logs that are DM-only never become sessions.

Can I import from World Anvil or LegendKeeper?

If you can get your world out as markdown, yes. We accept generic folders of .md and .txt in a .zip, which is what the community World Anvil to Markdown converters produce, and what LegendKeeper markdown exports look like. There is nothing Obsidian-specific about the importer.

Can I import my vault again after I change it?

Yes. Import the updated .zip the same way. Notes you changed are updated, unchanged notes are skipped, and a session log that already became a session does not become a second one. Notes you deleted from your vault stay in the campaign until you remove them.

How big a vault can I bring?

Up to 50 MB per upload and 5,000 files, which comfortably covers a hand-written vault of several hundred notes. If your vault is larger, usually because of a compendium dump or embedded media, import a subfolder at a time.

Can the AI read my imported notes?

Yes. Request a quick overview or choose from 14 entity types in Build campaign records. Characters, locations, quests, factions, items, creatures and scenes become descriptive records; boards contain a text overview and source cards. Choose an existing session to save story threads and player decisions as records, or keep them as drafts. Events, relationships, map briefs and character sheet briefs become private draft notes. Review everything before saving. New records start hidden, and analysis containing private notes stays in private Notes. Each analysis supports up to 100 notes and 60 KB of extracted text.

Bring your whole campaign with you

Free to import, nothing rewritten, and your original vault untouched.