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.

FoldNotes will be a paid app. macOS will offer a subscription and a lifetime licence option. iOS pricing is still being finalised. There’s no free tier, but you can try the beta for free during the beta period.

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

Yes. The iOS app is a separate purchase and is currently planned for a TestFlight beta. It supports editing, folding, tasks, backlinks, focus modes, and iCloud sync with the Mac app. 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.

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.

Directly — not through the Mac App Store. You’ll download a signed and notarised DMG. Automatic updates are handled by Sparkle.

Yes. The macOS version will offer both a subscription and a one-time lifetime purchase. Details will be announced with the beta.

Email [email protected].