Importing
Run Import… from the command palette (Ctrl+P, or Cmd+P on macOS), choose what to import, then Choose and import… and pick it in your system’s dialog. Nether shows how far it has come, and Cancel stops it, keeping what it has made. When it is done, it says what it made and opens the first note when you click Open.
An import never changes what your vault already has: it goes in a folder of its own, named after what you chose, or with a number after the name when the vault has that folder already. Nether only reads what you import.
An Obsidian vault, or a folder of Markdown
Section titled “An Obsidian vault, or a folder of Markdown”Choose the folder. Every note comes over exactly as it is written, and
every other file, such as images, PDFs and canvases, beside it, in the same
folders, so links between them still work. Obsidian’s settings, in its
.obsidian folder, and other hidden files stay behind.
To work in an Obsidian vault as it is, without copying it, open its folder as a vault instead: Nether reads Obsidian’s notes as they are.
A Notion export
Section titled “A Notion export”In Notion, export your workspace or a page as Markdown & CSV, with subpages, then choose the ZIP file Notion gives you. It goes in a folder named Notion:
- Every page becomes a note named as Notion titled it, without the ID
Notion adds to its file’s name, and a page’s subpages go in the folder
beside it. Two pages of the same name in one place become
PlanandPlan 2. - A page’s title line goes, as the note’s name holds it; a title a file’s
name cannot hold, as
Plan: Q3/Q4, is kept as the note’s alias. - A database becomes a database, its rows the notes in
the folder beside it. Each row’s properties, the lines at the top of its
page, become its properties: numbers, dates (
October 30, 2026becomes2026-10-30), checkboxes and web addresses typed as they read, anything else as text. - Links between pages, to databases and to files become wiki links to where they now are, keeping their text, and images become embeds. A link to a page the export does not have stays as Notion wrote it, and the import says how many there are.
- Everything else in a page stays exactly as Notion wrote it.
A large export, which Notion splits into ZIP files inside its ZIP file, imports as one.
A Logseq graph
Section titled “A Logseq graph”Choose the graph’s folder, the one with pages and journals in it. It
goes in a folder named after it, with its folders as they are, so pages
still find their files in assets. Logseq’s settings stay behind.
- A page’s properties, its
key:: valuelines at the top, become its properties, withtagsandaliasas lists. - A namespace becomes folders:
area/projectis the notepages/area/project.md. - A journal is named by its date,
journals/2026-10-30.md, with the title Logseq gave it, asOct 30th, 2026, as its alias; links to it by that title link to it. - A block’s ID,
id:: …, goes after the block, as^…, and references to it,((…)), become links to it, as Obsidian writes block links;{{embed …}}becomes an embed. TODOandLATERbecome open tasks andDONEa done one; other markers stay as words.- Everything else stays as Logseq wrote it, the outline and other properties of blocks among it.
Markdown files
Section titled “Markdown files”Choose one or more .md files. Each becomes a note, as it is written, in a
folder named Imported.
Web pages
Section titled “Web pages”Choose one or more .html files, as articles you saved. Each becomes a
note in a folder named Imported, named by the page’s title, or its first
heading, with its text as Markdown: headings, paragraphs, lists, quotes,
tables, links, images and code. The page’s styles and scripts stay behind,
and its images keep their addresses. A title a file’s name cannot hold is
kept as the note’s alias.
CSV tables
Section titled “CSV tables”Choose one or more .csv files. Each becomes a database,
named after its file, with a note for each line of the table, named by its
first cell, in the folder beside it:
- Every other column is a property of the database, and each line’s cells are its note’s values.
- A column whose every value is a number, a date (
2026-11-15), true or false (also yes or no), or a web address gets that type; any other is text, so no value changes as it is read. - A name a file cannot hold, as one with
/or:, is shortened for the file, and kept whole as the note’s alias. Two lines with the same name becomeNameandName 2. - Cells past the header’s columns get columns of their own, named
Column 7and so on, and the import says so.