Skip to content

Import, export and offline reading

You can bring in a vault of Markdown notes from Dendron, Docusaurus or Obsidian. Nothing is created until you’ve seen exactly what the import would make and said yes.

  1. Zip the folder your Markdown lives in.
  2. Go to Import on the Notes tab of your settings (it’s at /your-name/-/import).
  3. Under A zip of your notes, choose the zip. It can be up to 20 MB, hold up to 5,000 files, and unpack to no more than 64 MB, with no single file over 8 MB.
  4. Select Read the archive.

DragonNotes works out which kind of vault it is:

  • Dendron: the dots in a file name like art.pencil.md become the hierarchy. root.md is skipped, because your home base takes its place.
  • Docusaurus: folders become the hierarchy, and each folder’s _category_.json gives it its name.
  • Obsidian: folders become the hierarchy.

For every format, a note’s front matter gives its title and tags where it has them. Otherwise the first heading becomes the title, and is taken out of the body so it isn’t shown twice.

Front matter also keeps two other things:

  • Order: a sidebar_position (or nav_order) puts notes in that order among their siblings. You’ll see it once you put notes in your own order.
  • Dates: created (or date) and updated (or lastmod) become the note’s own dates, so an old note doesn’t look as if it was written the day you imported it.

Other front matter is dropped.

Only the Markdown is imported. Images and other files in the vault are left behind.

The Ready to import page says which format it read the vault as, and counts what it found: notes From files, Folders added, Tags and Links rewired. Then it lists every note it would create, with its address and title. Before you go on, check the notices:

  • Folder notes will be added: some of your notes sit in folders with no note of their own. In DragonNotes every note needs a real parent, so those parents are created empty, marked folder.
  • Links point nowhere: these link to notes that aren’t in the archive. They’re left in the text exactly as written, so you can see what was meant.
  • Addresses already exist: you already have notes at those addresses. They’re unticked and skipped. An import never overwrites anything.

Untick any notes you don’t want. Select all and Select none help with a long list, and the count beside them says how many are ticked. Ticking a note also ticks the folders above it, because a note can’t exist without them.

Imported notes are private. To publish them all, turn on Make these notes public.

Select Import the ticked notes. You’re taken to your home base, with Import finished. Notes that were already there were left alone. Start again goes back to the upload form instead.

A preview is kept for six hours. If you come back to it later than that, you’ll see That preview has expired. Upload the archive again.

Links between notes in the vault, whether Obsidian and Dendron [[wikilinks]] or Docusaurus relative .md links, are turned into cross-links. They keep working when you later rename or move the notes.

Your notes are yours to take away, as often as you like. Go to Export your notebook under Your data on the Account tab of your settings (it’s at /your-name/-/export). There are two choices:

  • A folder of Markdown: a zip with one Markdown file per note, in folders that mirror your tree, and your images and attachments alongside. Links between notes become relative paths, so they work in Obsidian, VS Code or anything else that reads Markdown, and DragonNotes can import the zip again with its links intact. It also holds account.json, a complete copy of your notebook and account as JSON: your profile, preferences, templates, tags, the list of your files, and every note with its tags and when it was pinned. This is the one to keep as a backup.
  • One HTML file (Download as one page): your whole notebook as a single page you can open in any browser, with a contents list at the top and the images built in. It’s good for reading or handing to someone, but it can’t be imported back.

The file is named after your username and the date, such as miriam-notes-2026-09-24.zip.

Once you’re logged in, DragonNotes keeps copies of the notes you read, so you can still read them without a connection: on a plane, say, or a train through a tunnel.

  • It saves your most recently read note pages (around 60 of them) and the images on them, and throws the oldest away as it goes.
  • When you’re online, you always get the live version. The saved copy is only used when there’s no connection.
  • A saved copy says so at the top: Offline. and how long ago it was saved. Edit, the pin button, the note’s Settings, New note and the save buttons are greyed out, with Editing needs a connection. Reading works offline; writing doesn’t.
  • A page you haven’t read recently shows This page was not saved.

Only note pages and your home base are kept. Search, the map, tag pages and the editor need a connection.

DragonNotes can be installed on a phone, tablet or computer, where it opens in its own window like any other app.

  • Android (Chrome): open the browser menu and choose Install app or Add to Home screen.
  • iPhone and iPad (Safari): select Share, then Add to Home Screen.
  • Desktop (Chrome or Edge): select the install icon at the end of the address bar.

The installed app is called by the site’s name (DragonNotes unless the admin has changed it), and reads offline in the same way as the browser.