Skip to content

Releases: armamut/md-quicklook

MD QuickLook 1.2.3

Choose a tag to compare

@github-actions github-actions released this 25 Oct 12:46

Full Changelog: v1.2.2...v1.2.3

MD QuickLook 1.2.2

Choose a tag to compare

@github-actions github-actions released this 23 Oct 00:10

Full Changelog: v1.2.1...v1.2.2

MD QuickLook 1.2.1

Choose a tag to compare

@github-actions github-actions released this 22 Oct 18:30

Fixes

  • Previews could keep showing the previous version after an update. A running preview extension keeps the code it started with, so after installing or updating, Finder could go on using the old renderer until it was restarted. Installing, updating in the app and Reset Quick Look now restart the extensions too.

Math

  • Braket and set notation as in KaTeX: \Bra, \Ket, \Braket with delimiters sized to the content, \set and \Set (the first | separates).
  • \braket{\phi|\psi} no longer draws an extra bar.
  • 94.4% of KaTeX's function reference now typesets. See docs/math.md.

Updating

From 1.2.0: open MD QuickLook and click Check Now. From older versions:

curl -fsSL https://raw.githubusercontent.com/armamut/md-quicklook/main/scripts/install.sh | bash

MD QuickLook 1.2.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 17:30

Mermaid diagrams

```mermaid blocks are now drawn as diagrams, natively: no browser, no JavaScript. Flowchart, sequence, class, state, ER, pie, mind map, git graph and more, in light and dark. Diagrams are drawn in the background, so documents still open instantly; a diagram that cannot be drawn stays visible as its source. See examples/diagrams.md.

Layout comes from mermaid-rs-renderer, which is young: Gantt dates and timelines with several events per period differ from mermaid.js.

Check for updates

The app can now update itself: Check Now (or MD QuickLook ▸ Check for Updates…), then Install and Relaunch. It downloads the release from this repository only and verifies it before replacing itself. With Check for updates automatically on, it looks once a day when you open it. The Quick Look extensions still never use the network.

This version is the first one that can do this, so please install it the usual way:

curl -fsSL https://raw.githubusercontent.com/armamut/md-quicklook/main/scripts/install.sh | bash

Math

  • Braces, brackets and arrows over or under a formula, stretched to any width: \overbrace, \underbrace (with labels), \overbracket, \underbracket, \overgroup, \undergroup, \overlinesegment, \underlinesegment, \Overrightarrow, harpoons, under-arrows, \utilde.
  • Accents \mathring, \dddot, \ddddot, \widecheck, \underbar.
  • Fixed: a formula or diagram line no longer gets extra space above it; long unparsable source wraps instead of being cut off.
  • 93.9% of KaTeX's function reference now typesets (was 91.5%). See docs/math.md for what is supported and examples/math-unsupported.md for what is not, as drawn by the preview.

Smaller app

Both extensions now share one library, so the app stays at 30 MB (13 MB download) despite the diagram renderer.

Fixes

  • Front matter keys no longer take too much room in narrow previews.
  • Space after tables.

MD QuickLook 1.1.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 08:21

Native renderer — no more WebKit

Previews are now drawn natively with TextKit instead of a web view:

  • ~30 ms from request to a ready preview for a typical README (WebKit: ~200 ms). Large files show their first screen immediately; the rest is added in the background.
  • No web content or GPU helper processes, less memory.
  • Light and dark mode switch instantly, code colours included.
  • Finder thumbnails are now miniature pages drawn by the same renderer.
  • The WebKit renderer is still available: Use the WebKit renderer in the app.

Math, natively

Formulas are typeset with SwiftMath and the Latin Modern Math font — TeX-quality fractions, integrals, matrices and aligned equations, no JavaScript.

  • About 300 extra AMS/KaTeX symbols, KaTeX aliases (\R, \argmax, \dbinom, …), \tag, \overset/\underset/\stackrel, \xrightarrow and friends, text accents.
  • Environments: align, equation, alignat, array, rcases, multline, plus SwiftMath's aligned, cases, matrix family.
  • Fixed spacing: \quad/\qquad, \sin x, a, b.
  • 92% of the formulas in KaTeX's function reference typeset; unsupported commands (\underbrace, \boxed, \cancel, …) are shown as red source, like KaTeX does. See examples/math.md.

Install

curl -fsSL https://raw.githubusercontent.com/armamut/md-quicklook/main/scripts/install.sh | bash

Or download the zip below and move MD QuickLook.app to /Applications.

MD QuickLook 1.0.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 00:58