Skip to content

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.

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 Plan and Plan 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, 2026 becomes 2026-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.

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:: value lines at the top, become its properties, with tags and alias as lists.
  • A namespace becomes folders: area/project is the note pages/area/project.md.
  • A journal is named by its date, journals/2026-10-30.md, with the title Logseq gave it, as Oct 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.
  • TODO and LATER become open tasks and DONE a done one; other markers stay as words.
  • Everything else stays as Logseq wrote it, the outline and other properties of blocks among it.

Choose one or more .md files. Each becomes a note, as it is written, in a folder named Imported.

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.

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 become Name and Name 2.
  • Cells past the header’s columns get columns of their own, named Column 7 and so on, and the import says so.