Repository navigation
Releases: armamut/md-quicklook
Release list
MD QuickLook 1.2.3
Full Changelog: v1.2.2...v1.2.3
MD QuickLook 1.2.2
Full Changelog: v1.2.1...v1.2.2
MD QuickLook 1.2.1
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,\Braketwith delimiters sized to the content,\setand\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 | bashMD QuickLook 1.2.0
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 | bashMath
- 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
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,\xrightarrowand friends, text accents. - Environments:
align,equation,alignat,array,rcases,multline, plus SwiftMath'saligned,cases,matrixfamily. - 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 | bashOr download the zip below and move MD QuickLook.app to /Applications.
MD QuickLook 1.0.0
Full Changelog: https://github.com/armamut/md-quicklook/commits/v1.0.0