Leaflit 0.3.0 preview

Leaflit 0.3.0 adds explicit Source editing to the read-first macOS viewer. Open Markdown from your terminal, read it, and make a small correction when you need one.

• Switch between Read and Source with Option-Command-1 and Option-Command-2. Preview unsaved edits in Read, then save explicitly with Command-S. There is no autosave or automatic formatting.
• Jump from a broken Mermaid diagram or formula to its original source. Source includes native Find, Undo/Redo and a separate Save a Copy action.
• Keep drafts through external saves, replacements and read failures. Navigation, window closing and quitting offer Save, Cancel and Discard when changes remain.
• Restore sidebar width after small windows and Find, and keep Outline expansion and selection while the body refreshes.
• Improve repeated-heading parsing, math stylesheet readiness and document transitions. Startup and memory remain active performance work; measured results are linked below.

Apple Silicon only, macOS 14 or later. Runtime verification covers Apple M3 on macOS 26.6.2; older macOS versions have not been executed. The app is signed with Developer ID, notarized and stapled. This remains a preview in the personal tap, separate from official Homebrew cask acceptance.

Install or upgrade

brew install --cask magicsih/tap/leaflit
# Existing Homebrew installation:
brew update
brew upgrade --cask magicsih/tap/leaflit
leaflit ./plan.md

Or extract Leaflit-0.3.0-macos-arm64.zip and move Leaflit.app to Applications. The ZIP includes a launcher; Homebrew installs the command for you. Verify the ZIP with the attached SHA256SUMS and inspect release-manifest.json for its exact source and signed identity.

Known limits

An inactive public-download capture initially showed a blank Read body; one Source-to-Read transition displayed the document. The cause and ordinary foreground reproduction remain unconfirmed (#29). Rich-text Write, printing, PDF export, syntax highlighting and automatic updates remain deferred. Full-body formula copying can produce duplicated or fragmented text (#26); ordinary Source dark appearance remains unverified (#27). Spoken VoiceOver, earlier macOS, actual Finder drops and a network-isolated run also remain unverified.

Matched 100KiB runs measured total process footprint medians of 130.6 MiB in Read and 145.0 MiB in Source after Read. These are scenario measurements, not isolated editor cost; the original 60 MiB target is not met. See the Source verification and measurement protocol and preceding performance work.

Leaflit 0.2.0 preview

Leaflit 0.2.0 preview

Read Markdown from your terminal with a new Files and Outline sidebar and a dedicated Leaf Page app icon.

• Browse an explicitly chosen folder in Files and open Markdown in the current reading window, with Back for document navigation.
• Switch to Outline to jump to document headings and follow the current section while reading. Switch modes without losing the document, search or reading position.
• Collapse the sidebar when you want more reading space. Use Open Folder… (Shift-Command-O) and Toggle Sidebar (Control-Command-S) from the keyboard.
• Keep reading in small windows and at large text sizes, with corrections for narrow navigation controls and rendering progress after appearance changes.
• Recognize Leaflit by its centered page-and-leaf icon. The website explains the terminal reading workflow and shows actual app screens.

Install or upgrade

Download Leaflit-0.2.0-macos-arm64.zip from this release, extract it and move Leaflit.app to Applications. The personal Homebrew tap installs the app and launcher together:

brew install --cask magicsih/tap/leaflit
# If already installed:
brew update
brew upgrade --cask magicsih/tap/leaflit
leaflit ./plan.md

Apple Silicon only, macOS 14 or later. Runtime verification covers Apple M3 on macOS 26.6.2; earlier supported macOS versions remain unverified. The release provides a SHA-256 checksum and source/signing/notarization manifest. This is a preview distributed through the personal tap, separate from official homebrew/cask acceptance.

Known limitations

The app remains read-only. Printing, PDF export, syntax highlighting, Obsidian-specific syntax and automatic updates are not included.

Memory remains above the original 60MiB comparison target. Resource measurements identify their measured candidate, inputs and ranges; this icon/distribution update does not establish a new performance result. Follow-ups cover ordinary memory, post-close memory and startup latency.

Remaining verification includes spoken VoiceOver, earlier macOS, actual Finder-to-window drops, network-isolated execution, sidebar width persistence and additional icon surfaces. These are not recorded as passed. The sidebar QA history preserves the three review rounds, corrections and coverage limits.

Changes: v0.1.0...v0.2.0.

Distribution verification

The exact archive is Developer ID signed, accepted by Apple notarization, stapled and accepted by Gatekeeper. Its signed artifact and unauthenticated public download were each launched independently. Files, Outline, rendered Mermaid/math, relative navigation, Back and the bundled launcher have separately recorded execution evidence.

The personal Homebrew cask points to the immutable version/checksum. An isolated installation retained quarantine, passed signature/ticket/Gatekeeper checks and launched after the normal macOS first-open confirmation; its own bundled command opened a space-containing file. The existing global 0.1.0 installation was preserved, so a global CLI upgrade was not executed. Homebrew syntax/style passed; the full online audit remains failed on the preview-policy check. See the distribution verification report for exact identities, initial attempts and limits.

Leaflit 0.1.0 preview

Leaflit 0.1.0 preview

Leaflit opens Markdown files in a focused macOS reading window, with Mermaid diagrams and LaTeX math available offline.

• Open files from Finder, the Open menu or the leaflit command, with separate windows for separate documents.
• Read tables, task lists, code blocks and local images; search, copy, zoom and follow relative document links with Back.
• See saved changes automatically, including files replaced during saving, while keeping your reading position.
• Read in system light or dark appearance. Raw HTML is shown as text and remote document resources are blocked.

Install

Download Leaflit-0.1.0-macos-arm64.zip from this release, extract it and move Leaflit.app to Applications. The archive also includes a standalone launcher; Homebrew installs the app and command together:

brew install --cask magicsih/tap/leaflit

Apple Silicon only. The build targets macOS 14 or later; actual runtime verification currently covers Apple M3 on macOS 26.6.2. The public archive includes a release manifest and SHA-256 checksum.

Known limitations

Memory use exceeds the initial comparison target, and some runs retain WebKit memory after the last window closes. Memory profiling, window teardown and startup performance are follow-up work.

Spoken VoiceOver navigation and earlier macOS runtime verification remain incomplete: accessibility, compatibility. Editing, printing, PDF export, syntax highlighting and automatic updates are outside this preview. See the QA report and memory measurements for measured results and verification limits.

Distribution verification

The release archive is Developer ID signed, accepted by Apple notarization, stapled and accepted by Gatekeeper. The extracted signed app displayed the preview document with Mermaid and math; its bundled command, relative navigation, Back and a user-clicked link to the default browser passed on Apple M3 with macOS 26.6.2. The source document hash remained unchanged. Actual Finder-to-window drag and drop remains unverified.

Homebrew installation and the installed leaflit command were verified with quarantine retained. The personal tap is available; the online cask audit reports the prerelease-policy failure described in official cask readiness. See the distribution verification report.