How to import ZKN3 archives into Obsidian

Convert the supported archive content into Markdown, then inspect links and keywords before relying on the result. As of October 2026, Obsidian supports manually linked Markdown notes; Zettelkasten Archive Import reads version 3.8 archives directly.

Background

Deleted slots matter because later notes keep their original positions. The importer uses those positions for file names and repeat-import matching, rather than renumbering the live notes.

2 ways to do it

  1. Recreate selected notes as Markdown

    Keep the source application open and copy chosen note text into Markdown files. Name each file with its source position, then add supported headings, keywords and internal links by hand.

    Obsidian’s syntax guide documents headings and wikilinks. Check each target against the source before adding a link or ordered note sequence.

    limits
    You transfer keywords and relationships yourself. This method provides no archive preview or automatic repeat-import matching.
  2. Zettelkasten Archive Import from this site

    Save the version 3.8 archive and open it with Import a Zettelkasten 3 archive. Check live notes, deleted slots, missing targets and unsupported markup before selecting Create notes.

    Keep the same import folder for later imports, and retain zkn3_position on imported notes. Pro can compare two archives, but imports skip existing notes rather than updating changed ones.

    limits
    Attachments and several other archive components are not copied. Review the report and keep your original archive for reference.
    The archive preview lists live notes, a deleted slot, output paths, missing link targets and unsupported markup.
    Open larger

    MIT · no telemetry · core features free

    All features of Zettelkasten Archive Import

Review the result with Zettelkasten Archive Import

  1. Save your Zettelkasten 3 data and keep a copy of the archive.

  2. Run Import a Zettelkasten 3 archive and select the .zkn3 file.

  3. Check the folder, preview counts and report; preview again if you change the folder.

  4. Select Create notes and read the result counts and import errors.

  5. Open the first note to compare the result with the source.

Common questions

Why does the output skip a source number?

An empty source slot represents a deleted note. Later live notes keep their positions so their links do not shift.

How should I review a later archive?

Use Pro comparison to inspect added, changed and removed positions before importing. Review changed notes separately because the import only creates new notes.

Photo of Michael LipYou can now import ZKN3 archives into Obsidian.

Obsidian rewards people who share. NoteMods is just me and a lot of coffee. If this guide saved you a fight with the syntax, buy me a cup.