Root folders explained

Last updated

A root folder is a top-level folder you point Notate at. It is a real directory on your disk, and everything inside it (notes, subfolders, images) lives under that directory. A workspace is made up of one or more roots.

A root is a directory you choose

When you add a folder to Notate, that folder becomes a root: the top of a tree Notate tracks. Point it at an existing folder of markdown files or start an empty one. Notate reads and writes the files in place, so the folder stays usable in Finder, Explorer, or the Files app at the same time.

The root’s name is its folder name

A root shows in Notate with the same name as its directory on disk. There is no separate label kept alongside it, so what you see in the app always matches the folder on disk. This is why a couple of actions behave differently on a root than on a normal subfolder (see Renaming folders and roots).

One or more roots per workspace

A workspace can hold a single root or several. Use several when your notes live in more than one place, for example a work folder and a personal folder you want side by side. Switch between workspaces from the workspace switcher. Free plans include unlimited workspaces and unlimited roots.

Roots vs. subfolders

Everything below a root is an ordinary subfolder: create, rename, move, and delete them freely in the app, and the matching directories move on disk with them. A root is different because it is the mount point that connects Notate to a place on your disk. To add, move, or remove one, see Add, move, and remove a root.