Skip to content

Releases: pepperonas/marklook

MarkLook v0.0.1 - Native macOS Markdown Quick Look Previews

Choose a tag to compare

@pepperonas pepperonas released this 19 Sep 21:50

What's Changed in MarkLook v0.0.1

Initial public release of MarkLook — a lightweight, blazing-fast native macOS application and Quick Look Preview Extension (io.celox.marklook.preview) that brings rich Markdown rendering directly to the macOS Finder.

🌟 Key Highlights

  • Native Quick Look Extension: Modern data-based QLPreviewProvider and QLPreviewReply implementation for macOS 14+.
  • 🛠️ Full CommonMark & GFM Support:
    • Headings (H1–H6) with auto-generated anchor IDs
    • Bold, Italic, Strikethrough, Blockquotes, Ordered/Unordered lists, Nested lists
    • GFM Tables with column alignment and alternating row styling
    • GFM Task Lists with custom native checkboxes ([x], [ ])
    • Safe Link handling (target="_blank", rel="noopener noreferrer")
  • 🌈 Pure Swift Syntax Highlighting:
    • In-process tokenizer supporting Swift, Rust, Python, JavaScript, TypeScript, HTML, CSS, JSON, YAML, XML, SQL, Shell/Bash, and Markdown.
    • Zero JavaScript runtime overhead and zero client-side scripts.
  • 🎨 Apple Design Language:
    • System typography powered by Apple's San Francisco (SF Pro) and monospace font (SF Mono).
    • Automatic Dark and Light mode support (@media (prefers-color-scheme: dark)).
  • 🛡️ Hardened Sandboxing & Security:
    • Native App Sandbox (com.apple.security.app-sandbox) integration.
    • Strict HTML Sanitization stripping dangerous tags (<script>, <iframe>, <object>, <embed>, etc.) and event handlers (onerror, onload, onclick).
    • Path Traversal Guard preventing unauthorized access to disk resources outside document directories.
    • Tracking pixel protection via optional remote image blocking.
    • Automatic safe truncation with warning banner for documents exceeding 5 MB.
  • 💻 Native AppKit Companion Application (MarkLook.app):
    • Real-time Quick Look Extension status check via pluginkit.
    • Interactive side-by-side Markdown editor and live WebKit preview with sample files.
    • Configuration panel: Theme appearance (System/Light/Dark), Text Size, Content Width, Remote Images toggle, and Syntax Highlighting toggle.
    • Step-by-step Quick Look Finder activation and cache reset guide.
  • 🧪 Automated Test Suite:
    • 32 Unit and integration tests covering parser, sanitization, path traversal, syntax highlighting, settings, and performance benchmarks.

📦 Installation & Activation

  1. Download MarkLook-v0.0.1-macOS.zip below and extract it.
  2. Drag MarkLook.app into your /Applications folder.
  3. Open MarkLook.app once to register the extension with macOS.
  4. Go to System SettingsPrivacy & SecurityExtensionsQuick Look and verify MarkLook QuickLook Preview is enabled.
  5. In Finder, select any .md or .markdown file and press Space!

🔒 Checksums (SHA256)

9f5173a02613e0baa2d8b1fe2b19ebdd87a8745833297a8fe2fe09ecf28495ea  MarkLook-v0.0.1-macOS.zip