Floppy

A Markdown reader for Mac that shows what your AI changed

Floppy for Mac is a free menu bar app with a Markdown reader for Mac built in. It opens .md files as documents, in windows that look like a Floppy share page. When another app or an AI agent saves the file, the page updates in place and shows what changed. It needs macOS 14 or later.

fpy.sh/changelog/markdown-reader-for-mac · Updated 16 November 2026 · This page as Markdown

How do I open a Markdown file on a Mac with Floppy?

Install Floppy for Mac, version 1.7.0 or later, and double-click the file.

After the update to 1.7.0, Floppy is the app a double-click on a Markdown file opens. It takes that once, on the first launch of 1.7.0 or on a new install. To hand Markdown files back, switch off Open Markdown files with Floppy in Floppy's Settings, or in the welcome. They go back to the app that had them before, or to TextEdit when there was none. Floppy never takes it again after you switch it off or pick another app in Finder.

The other ways in are Open With in Finder, a file dropped on a reader window, File › Open…, Open Recent, and Open Markdown file… in the menu bar icon's right-click menu. Dropping a file on the menu bar icon still shares it.

What does the Markdown reader show?

A document, not raw text. The reader opens .md, .markdown, .mdown and .mkd files.

  • It draws headings, lists, task lists, tables, quotes, GitHub-style callouts like > [!NOTE], footnotes, front matter, images and bare web addresses as links.
  • Code blocks have syntax colours and a Copy button.
  • Contents of the ## and ### headings sit in the left margin, with a Jump to… field (⌘L). ⌥⌘S hides them, and a narrow window opens them as a drawer. Find is ⌘F.
  • One panel on the right (⌥⌘I, or the rail of icons on the window's edge) holds everything else: the link, Open in another AI, Versions, Text and the copies.
  • Text settings are under Text in the panel (⌥⌘T): the font (Serif, Sans, Mono or Round), the theme (Auto, Light, Sepia, Dark or Blackout), the size and the width.
  • Not in this version: Mermaid diagrams and math.

Floppy for Mac remembers where you stopped in each file. The space bar in Finder previews a file the same way, in the reader's font and theme. The Floppy for Mac guide lists every key.

What happens when an AI agent changes the file while it's open?

The page updates in place and keeps your place, whichever app saved the file. A dot appears on the rail, and Versions in the panel says what happened, like "Changed on disk just now. 2 paragraphs changed, 1 added."

  • Show changes on disk (⌥⌘C) highlights added words and strikes through removed ones. Added and removed blocks get a bar in the margin.
  • Next jumps to the next change.
  • The contents list puts a dot on each section that changed.
  • ✕ clears it.

The reader can't know who changed the file, so it names nobody.

Can I edit a Markdown file in the reader?

Yes, one block at a time. Press Edit (⌥⌘E) and click a block, or click the small pencil in the margin beside the block under the pointer. The block turns into its Markdown source in place.

  • Save or cancel. Click away or press ⌘↩ to save. Esc cancels, and ⌘Z undoes a saved edit.
  • Only that block's lines change. Every other line, the line endings, the final newline, the encoding and the file's permissions stay as they were.
  • If the file changes on disk meanwhile, your draft is kept. If that same block changed, the reader shows both and you choose.

Tick boxes tick on a click. There is no whole-document editor.

How do I share the file and keep its link up to date?

Press Share and the link is on your clipboard at once. Floppy for Mac remembers on your Mac which link the file belongs to, and writes nothing into the file. The bar shows the link, like fpy.sh/k3x9 · v1; click it for the panel.

  • Your file is ahead of the link: the link gets a dot, and Update link… (⌥⌘U) sends the whole file, up to 2 MB, as the next version, with an optional one-line note.
  • Someone else, or their AI, pushed a version: a dot appears on the rail, and Versions shows it, like "New on the link: v3 from Sam, 2 min ago", with their note and the link's versions. Show changes previews it in the page, and Apply to file writes it to your file.
  • Both changed: Update link puts your file on top as the next version, and theirs stays in the history. See theirs ↗ opens it on fpy.sh.

Nothing moves between the file and the link by itself, in either direction. Share, Update link and incoming versions use your Floppy sign-in.

How do I open the file in Claude or ChatGPT?

Press Open in Claude (⌥⌘O), the one accent button in the bar. Open in another AI in the panel has ChatGPT, Codex, Cursor and Copy prompt for any AI.

  • A shared file sends the same prompt as its share page: the link to read, and how to push a version back. If the file is ahead of its link, the panel asks whether to update the link first.
  • A file that isn't shared sends the document's text and uploads nothing to Floppy. A long document is copied to the clipboard instead, for you to paste.

For AI agents

An agent that edits the file on your Mac only has to save it: the reader shows what changed.

For a shared file, an agent works on the link:

  • It pushes an edit with the push_version MCP tool, or with PUT /api/v1/links/<slug>/versions. The version shows up in the reader's Versions panel, with a dot on the rail.
  • GET /api/v1/links/<slug>/versions lists a Markdown link's versions: who pushed each, the note, when, the version it was based on, and a read_url.
  • GET /api/v1/links/<slug>/versions/<n> returns one version's text.

Floppy for Mac uses these two GET calls to learn that a link has moved on. The rest is in the agent docs.

Questions people ask

Is the Markdown reader in Floppy for Mac free?

Yes. The Markdown reader is part of Floppy for Mac, a free download for macOS 14 or later. Reading needs no account.

How fast does Floppy for Mac open a Markdown file?

Measured on an M1 Pro with Floppy already running, a 20 KB document is on screen in about 60 ms. A dense 46 KB one, mostly tables and code, takes about 160 ms.

Does Floppy for Mac sync my Markdown files?

No. Floppy for Mac has no syncing or cloud storage of its own. A Floppy link is the sharing.

Is there a Markdown reader for Windows or iPhone?

Not from Floppy. The Markdown reader is in Floppy for Mac only. A shared Markdown link opens as a document in any browser.

What shipped in v1.43.0

  • Floppy for Mac 1.7.0 opens Markdown files as documents on a double-click. Open Markdown files with Floppy, in Settings, switches that off
  • When another app or an AI agent saves the file, the page updates in place and Show changes marks what's different
  • Press Edit and click a block to change its Markdown. A save changes only that block's lines
  • Share copies a link, Update link sends the next version, and Open in Claude opens the document in Claude, ChatGPT, Codex or Cursor

See it in the changelog

Related

Continue with GoogleFree to start. No account needed to open a link.