glushchenko/fsnotes

★ 7,360SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((FSNotes))
    Storage
      Plain text files
      Your file system
      iCloud Dropbox sync
    Editor features
      Markdown formatting
      Code highlighting
      Math MathJax
      Mermaid diagrams
    Security
      AES-256 encryption
      Git versioning
    Platforms
      macOS app
      iOS app

mindmap root((FSNotes)) Storage Plain text files Your file system iCloud Dropbox sync Editor features Markdown formatting Code highlighting Math MathJax Mermaid diagrams Security AES-256 encryption Git versioning Platforms macOS app iOS app

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Take and organize thousands of Markdown notes as plain files you can open in any text editor.

USE CASE 2

Sync your notes between Mac and iPhone automatically using iCloud Drive or Dropbox.

USE CASE 3

Encrypt sensitive notes with AES-256 so they stay private even if someone accesses your files.

USE CASE 4

Write notes with math formulas, code snippets with syntax highlighting, and Mermaid diagrams.

Tech stack

Swift

Getting it running

Difficulty · easy Time to first run · 5min

Use, copy, modify, and distribute freely for any purpose, including commercial use, with no restrictions beyond keeping the copyright notice.

In plain English

FSNotes is a notes manager for macOS and iOS, built around plain text and Markdown files. Notes are stored as regular files on your file system rather than in a proprietary database, which means you keep full ownership of your data and can open your notes with any text editor. The macOS app is designed to stay fast even with large collections. The README mentions it handles 10,000 or more files without slowing down. Notes can be organized across multiple folders and tagged for easier searching. Keyboard shortcuts are a central part of the design, so most actions can be done without touching a mouse. The editor supports Markdown formatting, inline images, syntax highlighting for over 30 programming languages, cross-note links using double-bracket notation, and rendering of Mermaid diagrams and MathJax math notation. Files sync through iCloud Drive or Dropbox, so the same notes are available on both Mac and iPhone or iPad. An external editor can also be used on the Mac side, and changes made there will show up in the app automatically. Encryption is available using AES-256 for notes that need to be kept private. Git-based versioning and backups are an optional feature for those who want a history of changes. The iOS app shares the core features, syncing with iCloud Drive and keeping pinned notes in sync with the desktop version. It also supports TextBundle containers, encrypted notes and folders, Git integration, and the ability to create simple web pages from notes. FSNotes is written in Swift 5 and is open source under the MIT license. The apps are available on the Mac App Store and iOS App Store.

Copy-paste prompts

Prompt 1

How do I set up FSNotes to sync my notes between my Mac and iPhone using iCloud Drive?

Prompt 2

I want to enable Git versioning in FSNotes so I have a history of every change to my notes, how do I configure it?

Prompt 3

How do I create cross-note links in FSNotes using double-bracket notation like in Obsidian?

Prompt 4

Walk me through encrypting a folder of private notes in FSNotes with AES-256.

Prompt 5

I use an external Markdown editor on my Mac, how do I make FSNotes pick up changes I make outside the app?

Open on GitHub → Explain another repo

← glushchenko on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.