v1.6.0

Reader.md 1.6.0

v1.5.0

Reader.md 1.5.0

v1.4.0

Reader.md 1.4.0

v1.3.2

Reader.md 1.3.2

Reader.md v1.3.1

What's new

• Frontmatter as a table — YAML frontmatter (--- … ---) now renders as a clean key/value table like VS Code, instead of showing up as a giant heading. Folded scalars collapse to one line; list values become bullets.
• About panel — a proper About Reader.md menu item showing the app name, version, and build number.

Install

Download Reader.md.zip, unzip, and drag Reader.md.app to Applications. It's ad-hoc signed, so on first launch right-click → Open to clear quarantine.

Reader.md v1.3.0

Hidden folders and reorderable roots.

What's new

• Scan hidden folders — files inside dot-prefixed folders (e.g. .github) are now included when you add a folder. Noisy dot-dirs (.git, .svn, .next, .cache, node_modules, dist, build) are still skipped.
• Reorder roots — drag a folder in the sidebar over another to reorder them; the order sticks across launches.

Install

1. Download Reader.md.zip below and unzip.
2. First launch shows "Apple cannot check it for malicious software" (it isn't notarized). Clear it once:
   • Right-click the app → Open → Open, or
   • Terminal: xattr -dr com.apple.quarantine "/path/to/Reader.md.app"

Requires macOS 13+.

Reader.md v1.2.0

Drop files anywhere, and tidy up your recents.

What's new

• Drop onto the body — drag a .md / .markdown / .mdown / .mdx file (or a folder) anywhere on the window, including the rendered content, to open it. Previously the reading area swallowed the drop.
• Clear recents — a Clear button in the sidebar's RECENTS header wipes the whole list.
• Remove one recent — hover a recent row and click the ✕ to drop just that entry.
• Collapsed by default — sidebar folders now start collapsed instead of fully expanded (search still reveals matches).

Install

1. Download Reader.md.zip below and unzip.
2. First launch shows "Apple cannot check it for malicious software" (it isn't notarized). Clear it once:
   • Right-click the app → Open → Open, or
   • Terminal: xattr -dr com.apple.quarantine "/path/to/Reader.md.app"

Requires macOS 13+.

Reader.md v1.1.0

Open individual markdown files — not just folders.

What's new

• Open File… (⌘O) — open a single .md file directly. Add Folder… moved off ⌘O.
• Drag & drop — drop a .md / .markdown / .mdown / .mdx file onto the window to open it (folders still register as roots).
• Default markdown opener — the app now declares itself a Markdown handler, so you can set it as the system default and double-click .md files to open them in Reader.md. Files opened from Finder render straight away.

Install

1. Download Reader.md.zip below and unzip.
2. First launch shows "Apple cannot check it for malicious software" (it isn't notarized). Clear it once:
   • Right-click the app → Open → Open, or
   • Terminal: xattr -dr com.apple.quarantine "/path/to/Reader.md.app"
3. To make it the default markdown app: right-click any .md file → Get Info → Open with → choose Reader.md → Change All…

Requires macOS 13+.

Reader.md v1.0.1

Patch release fixing the "damaged and can't be opened" error teammates hit after extracting the shared app.

What's fixed

• The .app is now ad-hoc code-signed, so a downloaded copy is no longer flagged as damaged.
• App resources moved to Contents/Resources so a packaged build loads them correctly (previously only worked on the dev machine).

Install

1. Download Reader.md.zip below and unzip.
2. First launch shows "Apple cannot check it for malicious software" (it isn't notarized). Clear it once:
   • Right-click the app → Open → Open, or
   • Terminal: xattr -dr com.apple.quarantine "/path/to/Reader.md.app"

Requires macOS 13+.

Reader.md 1.0.0

Native macOS markdown viewer.

Install: unzip, then right-click Reader.md.app → Open → Open (needed once — not notarized).

Requires: Apple Silicon Mac, macOS 13+.