How to import Diaro backups into Obsidian

Read a supported local backup into dated Markdown notes, then compare sample entries with the source journal. As of October 2026, Obsidian links to community Diaro migration guidance and accepts Markdown notes. Diaro Backup Import previews version 2 ZIP backups before writing notes and supported photos.

Background

Journal entries can depend on source dates and attachment records as well as their text. This importer keeps original time fields while using UTC dates for filenames.

2 ways to do it

  1. Move selected entries as Markdown files

    For a small selection, prepare Markdown notes from your source entries and move them into the vault. Obsidian documents moving Markdown files directly.

    limits
    You must transfer source metadata and local photos yourself. This workflow doesn't parse a Diaro ZIP.
  2. Diaro Backup Import from this site

    Select a supported unencrypted ZIP and review missing photos, counts and file conflicts. Create dated notes, then inspect the result and sample images.

    limits
    Audio, video and templates are outside the scope. Source hashes support comparison, but changed entries don't update existing notes.
    The Obsidian window shows journal text followed by a garden image copied from the backup.
    Open larger

    MIT · no telemetry · core features free

    All features of Diaro Backup Import

Check the result before relying on it

  1. Make an unencrypted Diaro ZIP backup and keep a copy.

  2. Run Import a Diaro backup from the command palette.

  3. Select the ZIP and review the folder, counts and warnings.

  4. Adjust naming or property mapping if needed, then preview again.

  5. Select Create notes and check the result counts, errors and sample photos.

Common questions

Why can a filename date differ from my journal display?

The importer uses UTC for its filename date. It retains source offset fields without interpreting their unit.

What does an absent entry in comparison mean?

The later backup lacks that source ID. This doesn't prove that you deleted the entry in Diaro.

What happens to an existing monthly review?

The importer keeps its contents and reports the path as an error. New reviews include only entries created during their import run.

Sources

Photo of Michael LipYou can now import Diaro backups 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.