LitePreview

LitePreview adds a formatted Markdown preview to Quick Look on macOS. Pressing Space on a Markdown file renders escaped HTML with a GitHub-like style. The preview follows the current system appearance automatically, using GitHub Light or GitHub Dark Dimmed colors.

The extension handles Markdown only. It has no settings, editor, background process, updater, analytics, or network access. Other file types continue to use the standard macOS Quick Look providers.

Install

macOS 14 or newer, Xcode, and XcodeGen are required:

brew install xcodegen
./scripts/install.sh

The script builds a locally signed extension, installs its required invisible container at ~/Applications/LitePreview.app, and enables it for the current user. The container has no UI and exits immediately when opened.

LitePreview can be disabled without deleting it in System Settings → General → Login Items & Extensions → Quick Look. To remove it completely, run:

./scripts/uninstall.sh

Development

Generate the Xcode project and run the test suite with:

xcodegen generate
xcodebuild \
  -project LitePreview.xcodeproj \
  -scheme LitePreview \
  -configuration Debug \
  -destination 'platform=macOS' \
  CODE_SIGN_IDENTITY=- \
  CODE_SIGNING_ALLOWED=YES \
  test

GitHub Actions only generates the Xcode project and runs this verification build and test suite. It does not package or publish the application.