Docs

Import and export

Bring notes into Blocknotik from Markdown, text files or zip archives, and take them out again as a Markdown zip or a small static website.

Both directions live in the Menu at the top right. Neither of them ever changes or deletes existing notes.

Import

Menu → Import files… opens the usual file dialog. You can pick several files at once:

  • **.md and .markdown** — copied into the main notes folder as .md files.
  • **.txt** — copied the same way and renamed to .md. Plain text is valid Markdown, so it just works; at most some line breaks look different.
  • **.zip** — every .md, .markdown and .txt file inside becomes a note, and its folders are kept: Recipes/Bread.md in the archive ends up as Blocknotik/Recipes/Bread.md. Images in the archive (PNG, JPEG, GIF, WebP, SVG, AVIF) are copied along, so pictures referenced from the notes keep working.

A message tells you how many files were imported and how many were skipped.

What happens with name clashes

Nothing is overwritten. If a note with the same name already exists in that folder, the imported one gets a number: Bread 2.md. An image whose name is already taken is skipped and the existing file kept.

What is skipped

  • Other file types inside a zip (PDFs, documents, programs).
  • Hidden files and folders, and the __MACOSX folders some archivers add.
  • Files larger than 8 MB, more than 5,000 files from one archive, and uploads larger than 200 MB in total.

Paths in a zip are cleaned before anything is written: .., drive letters and absolute paths are removed, so an archive can't place files outside your notes folder.

Moving from another notes app

Most note apps can export Markdown, often as a zip. Import that zip as it is. Things to check afterwards:

  • Links: if the other app used [[double brackets]], they will work as long as the titles match the file names. Markdown links to .md files work in the preview too.
  • Front matter (metadata between --- lines at the top) is not interpreted and will show as text; delete it or leave it.
  • Attachments that aren't images stay out — keep them in the original export.

If your notes are already a folder of Markdown files, you don't need import at all: start Blocknotik with --dir pointing at that folder.

Export

Markdown (.zip)

Menu → Export Markdown (.zip) downloads blocknotik-YYYY-MM-DD-md.zip with all notes and images exactly as they are on disk, folders included. The .trash folder and hidden files are left out. Use it as a backup or to hand your notes to another program.

HTML (.zip)

Menu → Export HTML (.zip) turns the notes into a small static website:

  • one .html page per note, in the same folders;
  • index.html with a list of all notes and a section for each tag;
  • style.css with light and dark colours;
  • images copied next to the pages.

Links between notes become ordinary relative links, so the site works when opened straight from disk (double-click index.html) or put on any web server. Tag links lead to the tag sections on the index page. Links to notes that don't exist go nowhere.

The pages contain no scripts and load nothing from the internet.

Printing and PDF

There's no separate PDF export. Open the note in Preview mode and use the browser's print dialog (Ctrl+P, Save as PDF), or print a page from the HTML export.