Repository navigation
Releases
Quick Markdown 1.0.11
What's new in 1.0.11
A polish release on top of 1.0.10's big rendering update.
Added
<kbd>keys look like keycaps in the Preview.- New README screenshots of diagrams, code and maths, callouts and the other extras, plus a refreshed theme gallery.
Fixed
- Mermaid pie charts use distinct colours. Slices were drawn in near-identical greys (almost black on dark themes); they now use GitHub's palette.
- Emoji in headings show as emoji in a
[TOC], not as:sparkles:. - Front matter lists written as
[a, b]show asa, b, without the brackets. - The keyboard shortcuts in the docs now match the menus: Toggle Preview / Source is ⌥⌘P and Read Aloud is ⌥⌘. (Option-Command-period).
The full list is in CHANGELOG.md.
Install
Download Quick.Markdown-1.0.11.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If Quick Markdown is running, the installer quits it (your work is autosaved), installs the update and relaunches it. Existing installs will also see an update notification.
Verify the download:
shasum -a 256 -c 'Quick.Markdown-1.0.11.pkg.sha256'
Quick Markdown 1.0.10
What's new in 1.0.10
Quick Markdown now renders everything GitHub does, and then some, all offline.
Added
- Syntax-highlighted code in 193 languages, in the Preview, the Source view and PDF export, with GitHub's light and dark colours.
- Equations with KaTeX:
$…$,$$…$$, GitHub's```mathand$`…`$, and LaTeX\(…\)/\[…\]. - Mermaid diagrams (flowcharts, sequence, state, class and the rest), in light or dark to match your theme.
- GitHub alerts:
> [!NOTE],[!TIP],[!IMPORTANT],[!WARNING],[!CAUTION], plus Obsidian-style callouts with custom titles, extra types and folding. - Full CommonMark and GitHub Flavored Markdown conformance. The renderer passes every example in the GFM spec, cmark-gfm's extension tests and CommonMark 0.31.2, apart from documented places where it deliberately matches GitHub.
- Bare URLs and email addresses become links, with GitHub's rules.
- Footnotes use GitHub's layout, and can hold paragraphs, lists, quotes and code.
- Popular extensions: emoji shortcodes (
:tada:),==highlight==, inline footnotes, abbreviations, definition lists, wiki links and![[image]]embeds,[TOC], custom heading ids, front matter shown as a table, and GitHub's light/dark-only images.
Changed
- No smart punctuation, as on GitHub: quotes stay straight and
--stays two hyphens. - Scripts in a document no longer run in the Preview.
<script>,<style>,<iframe>and similar tags show as text, as on GitHub.
Fixed
- The view no longer jumps while an agent or another app edits the file. The Preview updates in place and keeps your reading position; the Source view only replaces the changed text.
- Lists no longer look double-spaced, ordered lists keep their starting number, and table column alignment shows in the Preview.
- Heading anchors keep non-ASCII letters, and duplicate headings get distinct anchors.
- A document starting with a
---rule no longer loses its opening section. - PDF export no longer clips the last line.
- Copy Formatted includes relative images.
- Embedded SVGs render with scripts, network and file access disabled.
The full list is in CHANGELOG.md.
Install
Download Quick.Markdown-1.0.10.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If Quick Markdown is running, the installer quits it (your work is autosaved), installs the update and relaunches it.
Verify the download:
shasum -a 256 -c 'Quick.Markdown-1.0.10.pkg.sha256'
Quick Markdown 1.0.9
What's new in 1.0.9
Fixed
- Copying from the Preview no longer carries the theme's colours into the pasteboard. WebKit's default copy serialises the computed style of every element, so each paragraph landed in Mail, Outlook or Word with an inline
colorand an opaquebackground-colortaken from the preview theme. That was invisible in a light compose window but rendered every paragraph as a grey box in dark mode, for the sender and for anyone reading the message in a dark-mode client. The preview now interceptscopy, strips preview-only attributes from the selection and hands clean semantic HTML to Swift, which writes it to the pasteboard (with plain text) wrapped in a colour-free font and size declaration, so the receiving app's own theme applies. - Bumped
MARKETING_VERSIONto 1.0.9 andCURRENT_PROJECT_VERSIONto 11.
Install
Download Quick Markdown-1.0.9.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If you're upgrading from 1.0.8, the installer postinstall script will quit the running app for you, wait for it to close, and relaunch the new version automatically. Your work is autosaved as part of the quit.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.9.pkg.sha256'
Existing 1.0.8 (and earlier) installs will see an update notification on next launch.
Quick Markdown 1.0.8
What's new in 1.0.8
Fixed
- File ▸ Print… now produces a real, fully-paginated printout. Previously the menu item was wired to
NSView.printView(_:), which routed through the responder chain to either the editor'sNSTextViewor the preview'sWKWebView— both produced blank pages. Printing now uses the same paginated HTML → WebKit → PDF pipeline as Export as PDF and hands the result toNSPrintOperationviaPDFDocument. - Fixed a follow-up bug where the print sheet preview looked correct but the printer spooled an empty job and never ejected paper. The
PDFDocumentandNSPrintOperationare now retained for the full lifetime of the sheet-modal session and released in adidRuncallback, so the operation always has something to draw. - Bumped
MARKETING_VERSIONto 1.0.8 andCURRENT_PROJECT_VERSIONto 10.
Install
Download Quick Markdown-1.0.8.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If you're upgrading from 1.0.7, the installer postinstall script will quit the running app for you, wait for it to close, and relaunch the new version automatically — your work is autosaved as part of the quit.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.8.pkg.sha256'
Existing 1.0.7 (and earlier) installs will see an update notification on next launch.
Quick Markdown 1.0.7
What's new in 1.0.7
Changed
- Quick Markdown is now a universal binary and runs on macOS 15 Sequoia or newer. Previous releases required macOS 26 Tahoe and shipped Apple Silicon only. The deployment target was lowered from
26.0to15.0acrossproject.yml(top-level, target, andMACOSX_DEPLOYMENT_TARGET),ARCHSis pinned to$(ARCHS_STANDARD)(arm64 x86_64on macOS), andONLY_ACTIVE_ARCHis forcedNOfor the Release configuration so archives always ship both slices. CI no longer gates the build onmacosx26SDK availability. Verified withlipo -infoshowingx86_64 arm64in the produced binary. - Bumped
MARKETING_VERSIONto 1.0.7 andCURRENT_PROJECT_VERSIONto 9.
Install
Download Quick Markdown-1.0.7.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If you're upgrading from 1.0.6, the installer postinstall script will quit the running app for you, wait for it to close, and relaunch the new version automatically — your work is autosaved as part of the quit.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.7.pkg.sha256'
Existing 1.0.6 (and earlier) installs will see an update notification on next launch.
Quick Markdown 1.0.6
What's new in 1.0.6
Fixed
- In-document anchor links now scroll the preview. Clicking a link like
[Jump to Part 6.5](#part-65--sync-an-out-of-date-fork)in Preview mode previously did nothing. Root cause:HTMLRendereremitted plain<h2>...</h2>tags with noidattribute, so when WebKit resolved the fragment URL there was nothing in the DOM to scroll to. Headings are now stamped with a GitHub-flavour slugid(lowercase, non-alphanumerics stripped, spaces → hyphens — so "Part 6.5 — Sync an out-of-date fork" becomespart-65--sync-an-out-of-date-fork), matching what authors expect when they hand-write fragment links or copy a TOC from GitHub. - Broken relative
file://links now give feedback. Clicking a link like[Glossary](../../GLOSSARY.md)whose path doesn't resolve to a real file on disk previously appeared dead —NSWorkspace.shared.openwas called with no result check, so silent failures looked identical to a no-op. Quick Markdown now checks that the target exists first; if it doesn't, the preview beeps, reveals the nearest existing ancestor folder in Finder, and logs the missing path viaNSLogso you can see where the link pointed. Valid relative links still open exactly as before.
Changed
- Bumped
MARKETING_VERSIONto 1.0.6 andCURRENT_PROJECT_VERSIONto 8.
Install
Download Quick Markdown-1.0.6.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If you're upgrading from 1.0.5, the installer postinstall script will quit the running app for you, wait for it to close, and relaunch the new version automatically — your work is autosaved as part of the quit.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.6.pkg.sha256'
Existing 1.0.5 (and earlier) installs will see an update notification on next launch.
Quick Markdown 1.0.5
What's new in 1.0.5
Fixed
- Links in the rendered preview now open in your default browser. Clicking an
http(s),mailto:,tel:orsms:link in Preview mode previously did one of two unhelpful things: silently nothing, or — worse — it loaded the remote page inside the Quick Markdown preview pane, replacing your document. Root cause: on the macOS 26 SDK, theWKNavigationDelegate.decidePolicyFormethod'sdecisionHandlerparameter is declared@escaping @MainActor (...), and our implementation was missing the@MainActorannotation. Swift treated it as "nearly matching" the protocol but didn't actually bind it to the protocol slot, so WebKit fell back to its default "allow every navigation in-frame" policy and our route-to-system-browser code was never reached. The signature is now exact and every external scheme (http,https,mailto,tel,sms) is handed toNSWorkspace.shared.open. Same-page fragment scrolling (footnote refs, TOC anchors) still works inside the preview as before. target="_blank"andwindow.open(...)style links are now also caught via theWKUIDelegate.createWebViewWithcallback (WebKit asks the UI delegate for those instead of the navigation delegate). They open in the system browser too, instead of being silently dropped.
Changed
- Bumped
MARKETING_VERSIONto 1.0.5 andCURRENT_PROJECT_VERSIONto 7.
Install
Download Quick Markdown-1.0.5.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If you're upgrading from 1.0.4, the installer postinstall script will quit the running app for you, wait for it to close, and relaunch the new version automatically — your work is autosaved as part of the quit.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.5.pkg.sha256'
Existing 1.0.4 (and earlier) installs will see an update notification on next launch.
Quick Markdown 1.0.4
What's new in 1.0.4
Added
- Autosave on by default.
autosavesInPlacecontinuously writes edits to saved Markdown files in the background;autosavesDraftspersists never-saved Untitled windows into the app's per-containerAutosave Information/folder. Quitting the app — including from the installer's postinstall script during an upgrade — no longer prompts to save and no longer loses unsaved content. - Draft restoration on launch. Untitled documents that had real content when the app last quit now reappear on next launch. Empty / whitespace-only drafts are dropped and the leftover autosave file is cleaned up, so ghost Untitled windows from older bugs don't keep haunting you.
- Installer postinstall script. Upgrading over a running copy of Quick Markdown now gracefully quits the old version, waits up to 20 seconds for it to close cleanly, and relaunches the freshly installed copy in the user's GUI session. Combined with autosave, an in-place upgrade is now invisible — no save-changes prompts, no force-killed processes (in practice), no lost work.
Fixed
- Loose GFM task lists.
- [ ]items followed by a blank line and indented content (a code block or a second paragraph) now render with the checkbox on the same baseline as the item title, matching GitHub. Previously the checkbox sat on its own row above the title because swift-markdown wraps each item's first line in aParagraph, and<input type="checkbox">followed by a block-level<p>broke onto two lines. The HTML renderer now unwraps the leading paragraph of every task-list item, not just tight ones. - Code blocks in the live preview wrap long lines inside the box instead of forcing a horizontal scrollbar. Helps two cases at once: (a) over-indented list-item continuation paragraphs that CommonMark correctly classifies as indented code blocks (the common author mistake of aligning continuation under bold title text with 6 spaces instead of 2), and (b) genuine code blocks with very long lines (long shell pipelines, long URLs). The export pipeline is unchanged — code pasted into Word / Outlook / PDF still has strict
<pre>semantics.
Changed
- Bumped
MARKETING_VERSIONto 1.0.4 andCURRENT_PROJECT_VERSIONto 6.
Install
Download Quick Markdown-1.0.4.pkg below and double-click to install. The package is signed with Developer ID Installer: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
If you're upgrading from 1.0.3, the new installer postinstall will quit the running app for you, wait for it to close, and relaunch the new version automatically — your work is autosaved as part of the quit.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.4.pkg.sha256'
Existing 1.0.3 (and earlier) installs will see an update notification on next launch.
Quick Markdown 1.0.3
What's new in 1.0.3
Added
- Table grid picker.
Insert Table(⌥⌘Tor the new toolbar button) now opens a Word/Pages-style hover grid (up to 8 × 8). Hover to pick the size, click to commit. The new table lands at the caret with the first header cell selected so you can start typing immediately. - Cell-aware Tab navigation in Markdown tables.
Tabmoves to the next cell (selecting its text).Shift-Tabwalks backwards.Returnjumps to the next row.TaborReturnon the last cell appends a new row and re-aligns the pipes. - Realign Tables (
⌃⌥⌘T). Pretty-prints every Markdown table in the document so the pipes line up by column. Alignment markers are preserved. - Insert Table toolbar button (
tablecellsicon), so the feature is actually discoverable. - Hot-reload of sibling images. A new FSEvents-based
MediaWatcherre-renders the preview when a PNG / SVG / JPEG next to the open Markdown file is updated by an external editor.
Fixed
- Images whose paths contain spaces or other percent-encoded characters (e.g.
media/night%20sky.png) no longer fail to load. The percent-encoding pipeline now decodes-then-re-encodes instead of double-encoding. - Inline images (GitHub-style status badges, small icons) now flow horizontally in the live preview instead of stacking on their own lines, matching how GitHub renders them.
Changed
- README rewritten as a personal-tool sales sheet with screenshots, theme gallery, and an updated keyboard cheat sheet.
- Added a public
test-files/demo corpus that exercises every supported block, inline, and image case. - Bumped
MARKETING_VERSIONto 1.0.3 andCURRENT_PROJECT_VERSIONto 4.
Install
Download Quick Markdown-1.0.3.pkg below and double-click to install. The package is signed with Developer ID Application: Neil Johnson (8352865GK4) and notarized by Apple, so no Gatekeeper override is needed.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.3.pkg.sha256'
Existing 1.0.2 installs will see an update notification on next launch.
Quick Markdown 1.0.2
What's new in 1.0.2
Added
- In-app update notifier. On launch (throttled to once every 24 hours) and from the new Quick Markdown → Check for Updates… menu item, the app polls the GitHub Releases API and offers a download link when a newer version is available. Skip-this-version and remind-me-later choices are remembered.
- Fully sandbox-safe — uses only the existing
network.cliententitlement; no Sparkle, no XPC helper, no embedded keypair.
Changed
- Bumped
MARKETING_VERSIONto 1.0.2 andCURRENT_PROJECT_VERSIONto 3.
Install
Download Quick Markdown-1.0.2.pkg below and double-click to install. The package is signed with Developer ID Application: Neil Johnson (8352865GK4) and notarized by Apple — no Gatekeeper override is needed.
Verify the download:
shasum -a 256 -c 'Quick Markdown-1.0.2.pkg.sha256'
Existing 1.0.1 installs will see an update notification on next launch.