Everything you need, nothing you don't.
FoldNotes is a markdown notes app built for people who think in structure. Native on Mac and iOS, plain text on disk, and packed with features that serious note-takers actually use.

.md files in iCloud Drive. Open them in any editor.fn command-line interface for scripting, search, task management, and automation. macOSFoldNotes is a markdown notes app built for people who think in structure. It runs natively on Mac and iOS, stores everything as plain .md files in iCloud Drive, and has a set of features designed for writers, developers, and anyone who takes notes seriously.
Tasks, All in One Place
New in FoldNotes 1.3 for Mac and 1.6 for iPhone and iPad. Your tasks stay where you wrote them, as plain Markdown in your notes, and the Tasks view gathers them from every note into six tabs: Inbox, Today, Upcoming, Projects, All and Done. Every change you make there goes straight back to the task’s line in its note. The Task Board, a kanban of the same tasks, is a separate view on the Mac.
- Scheduled dates, new and much requested. Give a task the day you mean to work on it as well as its due date, so a report due on Friday can sit on Wednesday’s list. On the Mac, choose Schedule in its right-click menu, set Scheduled in the task pane, or drag its card to a day in the Task Board’s Week view. On iPhone and iPad, swipe a task left for Today or Tomorrow, or choose the day in its sheet.
- Today and Upcoming. Today shows what’s overdue, what’s due today and what you scheduled for today, then what you’ve done. Upcoming lays out the next seven days one by one, then a week at a time. The Inbox holds the tasks you jot down in your daily note until you give them a project or a date.
- Repeating tasks. Every day, every weekday, every week, every month on the 10th or on the 2nd Thursday, every year, or a rule of your own, such as every 2 weeks or the last Friday of the month. Tick one done and the next one appears on the line below, with its dates moved on.
- A task pane beside the list (macOS) edits the task you select: its words, status, scheduled date, due date, priority, project, repeat and comments. Select several tasks to change them all at once. On iPhone and iPad, tap a task to edit it in its sheet.
- New Task from anywhere. On the Mac, Control-Command-N works from the editor too, so you can add a task in the middle of a sentence. On iPhone and iPad, tap the round button in the Tasks view, or touch and hold the New Note button and choose New Task. It goes to your Inbox, in today’s daily note, or into the note you choose.
- Move to Note. Move a task to another note, with its comments and anything indented under it. Undo puts it back.
- A Week view on the Task Board (macOS). Drag a card to the day you’ll do it.
- Colours that mean one thing everywhere: red to act now, yellow soon or under way, blue not yet, green done.

Drawing macOS 26
New in FoldNotes for Mac 1.3. Click Insert Drawing in the editor’s bottom bar, or on a whiteboard, and draw with your trackpad or mouse: Apple’s pens, shapes, text boxes, and plain or lined paper in six colours. Double-click a drawing to change it, including drawings made on your iPhone or iPad. Convert to Text reads your handwriting, for you to add to the note or to the drawing.
Interactive Whiteboards
Lay your notes out on a canvas to plot a book, map a project or think something through. Boards are made on the Mac: click + on the Whiteboards row in the sidebar, or choose File › New Whiteboard…, and the board opens in its own window.
- Every card is the note itself, in the gallery’s look: its tags, its words and pictures as the Preview sets them, and its tasks and date. Change the note and its card follows.
- Fold sections on a card, scroll inside it, or jump to a section from its outline, and double-click a card (double-tap on iPad) to open the note. Two cards of one note can show different sections.
- Connect cards with arrows and lines, with labels and colours. Add text boxes, nine shapes to type in, and frames that carry what’s inside them. Turn a text box into a note when an idea grows up.
- Pictures and PDFs on a board. Put a picture or PDF from your attachments on a board, or drag a file in and it joins your attachments first. A picture keeps its shape as you resize it, a PDF shows its first page, and a double-click opens it in Quick Look.
- Task lists on a board. Put Today, Upcoming or any list from the Tasks view on a board, for everything or for one project, and it stays up to date. Click a task to change it, or tick it off, right there.
- Web links and YouTube videos. Paste a web address, drag one in from your browser on the Mac, or type one on its own in a text box, and it becomes a card with the page’s picture, title and site. A YouTube link shows the video’s thumbnail, and a double-click opens it.
- Lead from one board to another with a card or a
[[link]], with Back and Forward. - Saved beside your notes in the open JSON Canvas format, and synced through iCloud like your notes. Arranging cards never changes your notes; a task you change in a task list changes in its note, as in the Tasks view.
- On iPad and iPhone. Your boards sync to FoldNotes for iPhone and iPad. On iPad and an open iPhone Duo, work on them: drag notes and other boards in, connect them, and add text boxes, shapes, frames, task lists, and pictures and PDFs from your attachments. On iPhone, look around a board and open its notes.
- Sample boards to try. FoldNotes comes with three, on the Mac, iPhone and iPad, under Whiteboards › Samples in the sidebar: a short tutorial to practise on, a tour of what a board can do, and a map of how FoldNotes fits together. On the Mac, iPad and an open iPhone Duo, try anything on them: nothing is kept, so each one starts fresh, and your own notes are never changed. On iPhone, look around them. A switch in Settings hides them.

Hide or Show Markdown
It’s now your choice. FoldNotes hides Markdown’s marks as you write, so a note reads like the finished page.
- Headings, bold, italic, highlights, links and quotes show as they look. Links read as their words and still work.
- Tasks draw as squares: click or tap one to move it to its next state.
- Put your cursor on something and its marks come back, right there and nowhere else, so your text moves only where you’re typing.
- Prefer to see every mark? On the Mac, choose Focus › Show Markdown (⌃⌘M), or turn on Show Markdown in Settings › Editor › Display. On iPhone and iPad, turn it on in Settings › Editor, or in a note under Focus & POS.
- Nothing in your notes changes: every mark stays in the file, so your notes open the same in any other app.


Neat Tables
- A table draws as a neat grid right in your note: a shaded header, a thin grid between the cells, your body font, and no pipes or dashes.
- Columns are sized to their words, so a word is never cut in two. A table too wide for the page moves sideways, under a two-finger swipe on the Mac or a drag on iPhone and iPad, and fades at the side where there’s more.
- A table acts as one piece: click or tap it to select it, copy or delete it whole, and double-click or double-tap it (or press Return on the Mac) to change its cells in the table editor.
- Copy part of a table in the table editor and paste it into a note as a table of its own, under the same column names.
- The file still holds a plain GitHub-flavoured Markdown table.

Code Syntax Highlighting
Name the language after a code block’s opening backticks and its code is coloured as you type: keywords, types, strings, numbers and comments, in the Preview’s own colours, light or dark to suit your theme. 28 languages, among them Swift, Python, JavaScript, TypeScript, HTML, CSS, JSON, YAML, shell, C, Go, Rust, Java, Ruby, PHP and SQL.

Folding
The core feature. Any heading or indented block can be collapsed with a single click. Fold an entire section to focus on what you’re working on, or fold everything to see your document’s outline.
- Headings at any level (H1 through H5) fold their contents
- Indented lists, tasks, and block quotes fold by nesting level
- Code blocks fold as a unit
- Fold state is saved per document and restored when you reopen

Inline Tasks
Tasks aren’t a separate system — they live right in your notes.
- Four states: not started
[ ], in progress[/], done[x], cancelled[-] - Add metadata inline:
due:2026-05-01,priority:high, and from Mac 1.3 and iOS 1.6scheduled:2026-04-28andrepeat:weekly - Task circle in the note list shows progress at a glance
- Inspector panel groups tasks by status, priority, or due date
- Each task has a stable UUID for deep linking

Manual Sort
Sort your notes by hand and the order sticks per tag. Switch to #novel/manuscript and chapters appear in narrative order. Switch to #novel/research and your source material appears in its own arrangement.
- Drag-to-reorder works on Mac, iPad, and iPhone
- Applies to one tag at a time — a specific tag like
#novel/manuscript, not a parent tag that combines several sub-tags - Each tag remembers its own order independently
- Saved to front matter and synced via iCloud — your arrangement appears on every device
- Daily notes are excluded automatically
- Doesn’t apply to All Notes or rule-driven views (saved searches, Favourites, Untagged) — those are derived lists, not curated ones
For writers, this turns the note list into a scene list. For PKM and research, it lets you arrange notes by relevance to the current thread of thought.
Search Every Note
Search reads every word of every note, and narrows as you go — with nothing to memorise.
- Pills under the search field:
tag:,has:tasks,is:favouriteandis:overdue. Tap one to add it, tap again to take it out. - Tags the easy way: tap
tag:and pick from your own tags as you type; the notes narrow as the path fills in. Capitals don’t matter, and a tag finds everything under it —tag:bookfinds notes tagged#book/the-plain-text-promise/outline. - Save a search: the bookmark button keeps the searches you use often — words, pills, or a regex pattern — one click away. Saved searches sync with your collection, so one saved on the Mac is waiting on your iPhone.
- Regex mode (Mac and iPad): switch the field to a regular expression and run it against every note’s body. Mistakes are flagged as you type; search only, no replace, so a one-character slip can’t spread. The help has patterns worth saving: tasks with no priority, empty headings, links, TODO markers.
Pills and saved searches: on the Mac from version 1.2.1, on iPhone and iPad from version 1.5.1.

tag:book finds every note under #book, has:tasks keeps the ones with tasks. The bookmark saves the search.iCloud Sync
Your notes are plain markdown files stored in iCloud Drive. No proprietary database, no vendor lock-in.
- Create and edit on Mac, pick up where you left off on iPhone or iPad
- Files are readable by any text editor
- Front matter stores metadata (tags, task IDs) without polluting the document
Tags and Backlinks
- Inline
#tagsanywhere in your text — the sidebar collects them automatically - Customise tags with icons and colours
[[Backlinks]]connect notes to each other- A references panel shows every note that links to the current one

Gallery View (macOS)
See your notes as visual cards in a waterfall layout.
- Filter by favourites, open tasks, recent changes, tags, or custom queries
- Sort by date modified, date created, title, or due date
- Group by tag
- Scale the cards from 50% to 120%: everything on the card scales together, so 50% packs the most notes on screen for a birds-eye sweep, while 120% gives large, easy-reading previews. Combine with the pane width (columns) to dial in exactly the density you want
- Click a card to open it alongside the gallery


Focus Modes
Strip away distractions and focus on your writing.
- Typewriter scrolling: keeps the cursor centred on screen
- Paragraph focus: dims everything except the current paragraph
- Sentence focus: dims everything except the current sentence
- Parts of speech: highlights nouns, verbs, adjectives, and adverbs in different colours

Daily Notes
One-tap daily note creation. Each day gets its own file in the .daily/ folder with a calendar in the sidebar for quick navigation.
Database Views
Query your notes like a database. Build custom views with filters, sorting, computed columns, and grouping — all driven by your notes’ metadata.

Inline Properties
A note’s properties sit at the top of the note, above its first line, and scroll with it. You change them where they stand, on Mac, iPhone and iPad.
- Type text and numbers in place, pick choices from a list with a search box, pick a date on a calendar, and click or tap a checkbox or the stars.
- Add a property from your collection’s list. Properties themselves are made on the Mac, in the Property Manager, so every note uses them the same way.
- When a value breaks a property’s rule, an orange dot and the reason show beside it, and your value is kept.
- Fold them to one line, or hide them, note by note. While they’re showing, the Preview shows them too.
- Changes from your other devices show at once, and in the file your properties stay plain text.

Properties, Reimagined macOS
Properties make your notes easy to find, sort and see in a table. They also multiply: Status and status, Priority and Priorty, a property made for one note and never used again. Every stray name splits your notes, and the searches and views built on them quietly miss the rest.
FoldNotes rethinks what a property is, in two halves: stop the mess starting, and find it when it gets in anyway, because a plain file can be edited by anything.
- Defined once. A property’s name, type, options and rules live in one place, the Property Manager, and your notes still hold plain lines of text. You add one to a note by picking it from a list, on Mac, iPhone and iPad.
- Checked as you name it. FoldNotes shows the ones that already exist or look alike. “status” can’t be made beside “Status”, and “Priorty” beside “Priority” takes a Create Anyway. Each property can say what it’s for.
- Rules that watch, and never block. A property can be required, or have a minimum, a maximum or a longest length. Break a rule and you see an orange dot and the reason, and your value is kept. Change a rule as your work changes, and every note is judged again at once.
- Tidy Up finds look-alike names, values that aren’t options, values that break your rules, and properties nobody uses, including what came from an edit outside FoldNotes, each with its fix a click away.
- Reach in from one place. See every note that uses a property and its value, and fix a value in a preview of the note without leaving the window.
- Merge folds one property into another. You choose what happens when a note has both, and every note, Database View and formula follows in one step. Cancel puts it all back.



Bike Outlines
Bike is an excellent Mac outliner, and its .bike files are readable HTML — an open format. FoldNotes edits those files directly, with no conversion and no import: point it at your Bike folder and every outline is there, on Mac, iPhone and iPad.
- Open in place. Edit an outline in FoldNotes and it is still a Bike file, with every attribute Bike wrote — due dates, priorities, done stamps, links, attachments — going back exactly as it was. Bike’s own version history includes edits made in FoldNotes.
- Links both ways. A
bike://link opens the row in Bike; a[[link in an outline reaches your notes. Follow a link and the list moves to the right folder. - Every row in one table. A database view pointed at your Bike folder: everything due this week, wherever it lives, filtered, grouped and sorted — made on any device.
- The Bike Board. Every task from every outline on one Kanban board — tick, drag, set attributes, and the outline changes underneath. macOS.
- Search the whole folder, plain text or regular expressions, reading outlines the way you read them.
- In the sidebar, with its subfolders, on Mac, iPhone and iPad alike: open, edit, search, and create outlines in the folder you are looking at, wherever you are.
CLI and MCP
FoldNotes is scriptable and AI-ready.
fncommand-line tool (macOS) — list, search, create, edit, and manage notes and tasks from the terminal. Pipe it into scripts, cron jobs, or shell aliases.- MCP (Model Context Protocol) server — lets AI assistants like Claude read your notes, search your collection, and work with your tasks directly, if you set it up. FoldNotes itself has no AI built in; see FoldNotes and AI for what an assistant you connect can see.
And More
- Markdown preview with live rendering
- Collection graph showing connections between notes
- 13 themes to choose from, light and dark
- Command palette for quick actions
- Keyboard shortcuts for everything
- Template system for new notes
- Picture and file attachments, with an Attachment Browser that shows where each picture is used: right-click it (touch and hold on iPhone and iPad, from version 1.5.1) and choose Used In to list the notes and whiteboards it appears in
- Full-text search across your collection
- URL scheme for deep linking from other apps and Shortcuts

