# Importing an Obsidian vault into nTilia > Import an Obsidian vault into nTilia as a folder or a ZIP: what carries over (titles, links, images, tags), what doesn’t, and the steps. Canonical: https://ntilia.com/en/guides/import-an-obsidian-vault Updated: 2026-10-19 ## 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 1. **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. 2. **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. 3. **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. 4. **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. > **Good to know** — Import the vault in one go: [[…]] links resolve within the Mission, so every linked note must be in it. A second import creates duplicates, not an update. Once synced, notes are readable by nTilia (not end-to-end encrypted); sensitive notes can stay on the device. ## 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. ## Go further - [Comparison: nTilia or Obsidian](https://ntilia.com/en/compare/obsidian) - [Obsidian alternatives](https://ntilia.com/en/alternatives/obsidian) - [Leaving Evernote](https://ntilia.com/en/alternatives/evernote) - [All features](https://ntilia.com/en/features) ## Sources - [Obsidian Help — How Obsidian stores data](https://obsidian.md/help/data-storage) - [Obsidian Help — Internal links](https://obsidian.md/help/links) - [Obsidian Help — Embed files](https://obsidian.md/help/embeds) - [Obsidian Help — Tags](https://obsidian.md/help/tags)