# 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.

Floppy 1.43.0, released 2026-11-16. Updated 2026-11-16. https://fpy.sh/changelog/markdown-reader-for-mac

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

Install [Floppy for Mac](https://fpy.sh/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](https://fpy.sh/docs/mac) 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](https://fpy.sh/changelog/markdown-version-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](https://fpy.sh/changelog/open-a-shared-file-in-claude-or-chatgpt): 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](https://fpy.sh/docs/agents).

## FAQ

### 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 1.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

## Related

- [Download Floppy for Mac](https://fpy.sh/mac)
- [Floppy for Mac guide: reading Markdown](https://fpy.sh/docs/mac)
- [Share a Markdown file as a web page](https://fpy.sh/changelog/share-a-markdown-file-as-a-web-page)
- [Version history for a shared Markdown file](https://fpy.sh/changelog/markdown-version-history)
- [Open a shared file in Claude or ChatGPT](https://fpy.sh/changelog/open-a-shared-file-in-claude-or-chatgpt)
- [Floppy for agents: MCP and REST docs](https://fpy.sh/docs/agents)

All releases: https://fpy.sh/changelog · Everything for LLMs: https://fpy.sh/llms.txt
