QuokkaMarkDownload ↓

Build in public

The work
behind the window.

QuokkaMark began as a one-evening question: how small can a genuinely pleasant Markdown reader be? This is the honest answer so far.

  1. RENDERING RELIABILITY

    Plain Markdown gets a native reading path

    Fixed blank documents opened from Finder or the app’s Open panel, made sandbox bookmarks best-effort instead of fatal, retained live-refresh access, and added a regression test using the Gradle README that exposed the bug.

  2. RELIABILITY

    Cold-launch file opening fixed

    Queued Markdown files delivered by Finder before the first window was ready, so double-click and Open With requests now survive a cold launch instead of being dropped.

  3. TRUSTED DISTRIBUTION

    Signed, notarized, and stapled

    Signed the app, Quick Look extension, and disk image with a Developer ID certificate, passed Apple’s automated notarization checks, and stapled the ticket for an ordinary Gatekeeper-approved installation.

  4. DISTRIBUTION

    A proper Mac disk image

    Replaced the ZIP-first install with a verified DMG containing QuokkaMark and the familiar Applications shortcut, ready for drag-and-drop installation.

  5. OPEN SOURCE RELEASE

    The quokka leaves the nest

    Moved QuokkaMark to an MIT-licensed public release, added its GitHub Pages home, packaged a universal Mac download, and published the development history.

  6. NAVIGATION

    Document Navigator and search

    Added a native hierarchical heading sidebar, stable anchors for duplicate headings, click-to-jump navigation, ⌘F search, visible highlighting, and match counts that avoid disturbing diagrams and equations.

  7. TECHNICAL DOCUMENTS

    Diagrams, equations, and export

    Bundled Mermaid, Marked, and KaTeX for completely offline rendering. Added PDF and standalone HTML export, live external-edit refresh, and a Finder Quick Look extension.

  8. RENDERING

    Markdown learned to breathe

    Replaced the original single-text rendering path with a block-aware reader for headings, paragraphs, block quotes, lists, tables, links, code, and print-friendly output.

  9. FIRST BUILD

    A tiny reader and a large personality

    Built the first native SwiftUI viewer with Open, drag-and-drop, recent files, printing, and zero editing controls. Named it QuokkaMark and gave it a cheerful document-reading mascot.

Want the next entry?

Watch the repository, open an issue, or build something delightfully specific on top of it.

Visit the repository ↗