Local-First Note-Taking, Explained

This guide explains what local-first note-taking actually means, why people choose it, the trade-offs to weigh, and how Folio approaches it.

The core idea

In a cloud-first notes app, the source of truth is the vendor’s database. You read and write through their app, and if the service changes or disappears, your access changes with it. In a local-first app, the source of truth is on your disk. The app is a way to view and edit files you already own.

Three properties tend to define local-first note-taking:

• Local source of truth. The canonical copy of your notes is on your machine.
• Works offline. You can read and write without a network connection.
• Open, durable formats. Notes are stored in formats you can open elsewhere, like plain Markdown or HTML.

Why people choose it

• Ownership. Your notes are files you control. You decide where they live and how they are backed up.
• Longevity. Plain .md and .html files will open in something a decade from now. Proprietary formats may not.
• Speed and privacy. Working against local files is fast, and nothing has to leave your machine unless you choose to sync it.
• Tool freedom. Because the notes are just files, other tools, scripts, and AI agents can read them too.

The trade-offs

Local-first is not automatically right for everyone. Be honest about the costs:

• Sync is on you. You choose how to sync across devices and back up. Cloud apps handle that for you by default.
• Real-time collaboration is harder than in a shared cloud document.
• Mobile and cross-platform support varies by app.

If your priority is frictionless multi-user collaboration in the browser, a cloud tool may suit you better. If your priority is ownership, durability, and working with your own files, local-first is the stronger model. It is also why a tool like an Obsidian alternative appeals to people leaving cloud notes, and what shapes the trade in Folio compared with Notion.

How Folio approaches local-first

Folio is a local-first notebook for macOS. Your notes are plain .md and .html files in one folder on your Mac. On top of those files, Folio gives you backlinks, a graph view, and full-text search, plus rich notes with tables, diagrams, and live charts.

Because everything is plain files in one folder, two things follow naturally:

• You can back up, version, or move your notes however you like.
• An AI coding agent (Claude Code, Cursor) can open the same folder and work alongside you, with no API key or plugin. Folio’s Agent panel and per-note history make that collaboration reviewable. See a notebook your AI agent can use for the full picture.