FAQ

A markdown notes app for Mac and iOS. It’s built around section folding, inline tasks, and iCloud sync. Your notes are plain .md files — no proprietary format, no lock-in.

FoldNotes is made by Foldsoft Pty Ltd, a small Australian company. It’s a solo developer project — one person designing, building, and supporting the app.

The iOS app (iPhone and iPad) is free to download and use. We may add optional Pro features later, but everything available today stays free. Download it from the App Store, sign in to iCloud, and start writing.

The Mac app is paid. Two purchase options at launch: a one-time lifetime licence and a subscription — pick whichever fits how you like to buy software. Both unlock every feature; the choice is just billing.

macOS 15 (Sequoia) or later, and iOS 17 or later (iPhone and iPad).

Yes — and it’s free. The iOS app supports editing, folding, tasks, backlinks, focus modes, and iCloud sync with the Mac app. iPad also gets the regex search toggle and saved-search library (iPhone keeps the simpler Spotlight-style search). iOS currently supports the default iCloud collection only — multiple collections are a macOS feature.

No. FoldNotes is a native app — AppKit on Mac, UIKit on iOS. There are no plans for a web or Windows version.

In iCloud Drive, as plain .md files. You can find them in ~/Library/Mobile Documents/iCloud~com~foldnotes/Documents/ on Mac, or in the Files app on iOS under iCloud Drive.

Yes. On Mac, you can point FoldNotes at any local folder. Notes will only be available on that machine.

Yes. FoldNotes files are standard markdown. FoldNotes adds a small YAML frontmatter block at the top of each file for metadata (ID, created date, task tracking). Other editors ignore this — the rest of the file is plain markdown.

Yes. On macOS, FoldNotes has dedicated importers for Obsidian, Bear, and Capacities — each handles tags, images, and folder structures from those apps automatically. There’s also a general File > Import Files option for .md, .txt, and TextBundle files from any app. The importers take care of frontmatter, image migration, and tag conversion so your notes are ready to use immediately.

Yes, on macOS. You can register multiple note collections and switch between them. Each collection is an independent folder with its own notes, tags, and tasks. iOS currently supports the default iCloud collection only.

Yes. Drag or paste an image into a note and FoldNotes stores it in a .attachments/ folder alongside your notes. Images are referenced using standard markdown syntax (![alt](image.png)), so they work in other editors too. Supported formats include PNG, JPEG, GIF, HEIC, WebP, TIFF, and SVG. Both Mac and iOS include an attachment browser where you can see all images across your collection, filter by referenced or orphaned, rename with automatic propagation to all notes, and insert images into your current note.

Tasks are lines in your notes that start with a checkbox: - [ ] My task. They support four states (not started, in progress, done, cancelled), due dates, priorities, and project tags. Tasks stay in context — right where you wrote them.

Yes. The Task Board (macOS) pulls tasks from every note into a kanban-style view. You can group by status, priority, due date, or project. The command line tool (fn tasks) also queries tasks across your collection.

Yes. Tasks are part of your markdown files, so they sync via iCloud like everything else.

FoldNotes uses iCloud Drive. Your notes are files in iCloud — the same sync mechanism Apple uses for Pages, Numbers, and other document-based apps. Changes sync automatically between your Mac and iOS devices.

Yes. Notes, tasks, tags, images, and daily notes all sync between Mac and iOS via iCloud Drive. The iOS app syncs with the default iCloud collection.

It’s as fast as iCloud Drive. Typically a few seconds between devices on the same network. FoldNotes detects changes as they arrive and updates immediately.

iCloud Drive uses Apple’s standard encryption — encrypted in transit and at rest on Apple’s servers. If you enable Advanced Data Protection on your Apple ID, your iCloud Drive data is end-to-end encrypted.

Folding lets you collapse sections of your document. Click the fold arrow next to a heading to hide everything underneath it — but it’s not just headings. Indented paragraphs, lists, nested tasks, code fences, and tables all fold too. You can collapse a nested task list down to its parent, fold away a long code block, or reduce a project plan to just its section headings. This lets you see the structure of a long document at a glance and focus on one section at a time.

Type [[Note Title]] to create a link to another note. FoldNotes tracks these connections and shows you every note that links to the current one in the references panel.

Yes. On macOS, you can export a note as PDF, HTML, Markdown, RTF, DOCX (Word), EPUB, or TextBundle. You can also export an entire collection as a ZIP archive, and database views can be exported as CSV. On iOS, you can export as PDF, HTML, Markdown, or RTF, and share via the system share sheet. Both platforms support printing.

No. FoldNotes is opinionated about its feature set. Everything is built in and designed to work together. There’s no plugin system, no scripting language, and no marketplace. This is a deliberate choice — it keeps the app simple and reliable.

Yes. fn is a macOS command line tool for searching notes, managing tasks, creating daily notes, and automating workflows. Install it from the FoldNotes menu.

The CLI ships with the Direct edition (the build you download from this site). The planned Mac App Store edition will not include the CLI — Apple’s App Store sandboxing rules don’t permit shipping a command line binary that installs into /usr/local/bin. If you need the CLI, buy the Direct edition.

An MCP (Model Context Protocol) server is planned, which will let AI assistants like Claude read and work with your notes. This will be available when the beta launches.

Sign up on the homepage with your email. We’ll send you a download link when the beta is ready. macOS first, iOS to follow.

The Direct edition is a signed and notarised build downloaded straight from this site, with automatic updates handled by Sparkle. This is the full version — it includes the fn command line tool.

A Mac App Store edition is planned for users who prefer to manage purchases through Apple. The App Store edition will NOT include the CLI (Apple’s sandboxing rules don’t permit shipping a binary that installs system-wide); everything else — editing, folding, tasks, sync, gallery, focus modes, snapshots — is identical.

Two purchase options:

• Lifetime licence — a one-time payment. Once you own it you own it, and you keep using it as long as your Mac supports the macOS version required.
• Subscription — a recurring fee with the same feature set.

Both options unlock every feature in the app; the only difference is billing. Pick whichever you prefer.

Final pricing for both the Direct edition and the planned Mac App Store edition will be announced with the beta.

Email [email protected].