Docs

Files, backups and sync

How Blocknotik stores notes on disk, how to back them up, and how to keep them in sync between computers with tools you already use.

On this page
  1. What's in the folder
  2. Using another folder
  3. Backups
  4. Sync between computers
  5. Git
  6. Phones and tablets
  7. Two copies at once

Blocknotik has no sync service and no account. Instead it keeps everything as ordinary files, so any tool that can copy a folder can also move your notes around.

What's in the folder

  • Notes — .md files, UTF-8, with Unix line endings (\n). Files with Windows line endings or a byte-order mark are read fine; when Blocknotik saves such a note, it writes it back with \n and without the mark.
  • Subfolders — create them with your file manager; Blocknotik shows notes from all levels. New notes from the app go into the main folder.
  • Images and other files — kept as they are. Images can be shown in notes, everything else is ignored.
  • **.trash** — deleted notes, with date and time in the file name.

Blocknotik writes each save to a temporary file first and then swaps it in, so a crash or a power cut in the middle of saving doesn't leave a half-written note. Temporary files start with .bn-tmp- and are hidden.

Nothing else is written: no database, no cache, no settings file. The interface language and the editor mode are stored in your browser.

Using another folder

Start the program with --dir:

blocknotik --dir "D:\Notes"
blocknotik --dir ~/Sync/Notes

or set the environment variable BLOCKNOTIK_DIR. The folder is created if it doesn't exist. You can point Blocknotik at a folder of Markdown files written by another program — it doesn't need any preparation.

Backups

Because notes are files, any backup you already have covers them: the system's own backup, a copy to an external drive, an archive by script. Two cheap extra options:

  • Menu → Export Markdown (.zip) produces a dated zip of all notes and images. Keep a few of them somewhere else.
  • The .trash folder keeps deleted notes until you empty it yourself.

Sync between computers

Any tool that keeps a folder identical on several machines will do: a file sync service, a self-hosted sync program, a network drive, a USB stick. Point Blocknotik at the synced folder on each computer.

Some practical advice:

  • Don't edit the same note on two machines at the same time. Sync tools work with whole files; if both sides changed one, you'll get two versions.
  • Blocknotik notices when an open note was changed underneath it. On the next save it doesn't overwrite the file but shows a bar: Load the version on disk or Keep mine.
  • If your sync tool creates conflict copies (files like Note (conflict 2026-11-17).md), they show up as separate notes. Compare them, merge by hand, delete the extra one.
  • Let the sync finish before quitting on one computer and starting on the other.

Git

A notes folder is a good Git repository: plain text, small diffs, full history.

cd ~/Blocknotik
git init
echo ".trash/" > .gitignore
git add -A && git commit -m "notes"

Commit and push whenever you like; Blocknotik picks up files changed by git pull the next time you switch back to its window, open a note or search. There's no Git integration inside the app — use the tools you already know.

Phones and tablets

There's no mobile version of Blocknotik. Since notes are Markdown files, any Markdown editor on the phone can open and edit the synced folder. Links in double brackets stay text there, but they'll still work when you're back on the computer.

Two copies at once

Nothing stops you from starting Blocknotik twice on the same folder, for example on two user accounts. It works — each copy reads the files changed by the other — but you're back to the advice about not editing the same note in two places.