Mardo is a native macOS Markdown viewer and editor from Floof Logic. It renders
ordinary .md files with Core Text and no web view, previews them in Finder
Quick Look, follows saves made by coding agents while keeping your unsaved
edits, and steps back through the states a file was in. This is its public
package, support, security, and issue-tracking repository. Mardo's
product source is private and is not published here.
Mardo runs on MarkEngineV3, its own engine, built by Floof Logic. Its measured numbers — speed, memory, large-file behavior, and correctness — and a sourced, dated comparison to the field are published, auditable, in ENGINEERING.md. Every figure names the gate that produced it and the date, and every change is a visible diff in that file's history.
Download the current signed and notarized Mardo release from mardo.app. Mardo requires macOS 14 Sonoma or later.
Install the current release from the Floof Logic tap:
brew install --cask flooflogic/tap/mardo
mardo --version
mardo "notes.md"The cask installs the same signed, notarized, Universal Mardo.app as the
direct download and exposes only the mardo command. The official bare
Homebrew command will be documented only after upstream acceptance.
Install the dependency-free macOS adapter in a project:
npm install mardo
npx mardo --version
npx mardo "notes.md"Or install it in a user-owned global npm prefix to expose mardo directly.
The package runs no install-time download or lifecycle script. On its first
explicit invocation it reads Mardo's canonical public release record, verifies
the immutable archive's size and SHA-256, verifies the extracted app's
Developer ID identity and notarization, and then runs the same signed native
mardo helper used by Homebrew. It does not require Homebrew or an app already
installed in /Applications. See NPM_CONTRACT.md for cache,
network, update, removal, and failure behavior.
- Report a reproducible public bug.
- Read SUPPORT.md before sharing logs or document examples.
- Report security vulnerabilities only through the private route in SECURITY.md.
Please do not attach private documents, license data, receipts, credentials, or other sensitive material to a public issue. Purchase, license, and private-file help belongs at support@mardo.app.
This repository contains reviewed public documentation and package adapters.
The Homebrew definition lives in
FloofLogic/homebrew-tap.
Neither public repository builds, signs, or modifies the private Mardo product.