Guide
Importing an Obsidian vault into nTilia
Page updated
The essentials
An Obsidian vault is just a folder of Markdown files: nTilia imports it as is, picked as a folder or zipped. The vault becomes a Mission named after it; each note keeps its title, its [[…]] links and its images, and subfolders become tags. Notes arrive as private drafts: nothing is published.
What a vault is, for nTilia
Obsidian keeps each note in a .md file, images alongside, and its settings in a hidden .obsidian folder. nTilia reads that folder the way Obsidian does: the file name is the note’s title, and it is what [[Title]] links point to. Settings, the trash (.trash) and hidden files are skipped.
Importing, step by step
Choose where the notes land
With no Mission open (All notes view or inbox), nTilia creates a Mission named after the vault. If a Mission is open, the notes join it.
On a computer: pick the folder
Menu ⋯ → Import a folder (Obsidian…), then select the vault folder. The browser announces how many files the folder holds, hidden ones included: the conversion runs on your device.
Elsewhere: import a ZIP
Compress the vault folder (Finder: Compress; Windows: Send to → Compressed folder; iPhone: Files app, long press → Compress), then menu ⋯ → Import .md, .docx, .txt or ZIP.
Check
Open a few notes: titles, links, images and tags. An image that is missing or unreadable stays in the text as its file name.
What carries over
- The title: the file name; a matching # Title at the top of the note is not doubled.
- Links: [[Note]], [[Note|alias]] (the alias is shown), [[folder/Note]]; Markdown links to another note in the vault become [[…]] links.
- Images: ![[image.png]] as well as standard Markdown image links, found in the vault the way Obsidian finds them (PNG, JPEG, WebP, GIF), compressed and stripped of EXIF and GPS metadata.
- Tags: one per subfolder, plus front-matter tags and #tags in the text (outside code).
- Embedded notes ![[Note]] become a link to the note.
What doesn’t
- Other front-matter properties: aliases, dates, status. Notes are dated the day of the import.
- PDFs, audio, video, Canvas files and Excalidraw drawings: their name stays in the text, the file is not imported.
- Links to a heading (#Heading) or a block (^id): the link goes to the note.
- Anything that depends on a plugin (Dataview, Tasks…): the text stays as is, uninterpreted.
Frequently asked questions
Do I need an Obsidian plugin?
No. nTilia reads the vault’s files directly: just pick its folder or make a ZIP of it.
Will a note marked public in Obsidian be published?
No. Every note arrives as a private draft; a status, visibility or id property in the front matter is ignored.
Can I import from a phone?
Yes, with a ZIP: on iPhone, compress the vault folder in the Files app, then import the ZIP into nTilia. Picking a whole folder depends on the browser; on a phone, a ZIP is the safest route.
Can I go back to Obsidian?
Yes: export the Mission as a ZIP of .md files and file it in your vault. Exported files are named after the note’s slug; check your [[…]] links afterwards.
Sources
Free · No credit card · Works offline