{"id":36581,"date":"2026-09-02T13:52:58","date_gmt":"2026-09-02T20:52:58","guid":{"rendered":"https:\/\/www.podfeet.com\/blog\/?p=36581"},"modified":"2026-09-02T13:52:58","modified_gmt":"2026-09-02T20:52:58","slug":"marked-ql","status":"publish","type":"post","link":"https:\/\/www.podfeet.com\/blog\/2026\/09\/marked-ql\/","title":{"rendered":"View Markdown Files in Quick Look with Marked QL"},"content":{"rendered":"

If you\u2019ve been using a Mac for a while, you know that you can tap the space bar with any file selected to invoke Quick Look, the built-in previewing app for files. Image files show the images, music plays, videos play, PDFs render, presentation and word processing files render nicely, and plain text files render as, well, plain text. Even Affinity Designer files render their images with Quick Look.<\/p>\n

You know I\u2019m a fan of Markdown, which is a plain text format that has superpowers when rendered by a Markdown interpreter. It uses hash marks for headings, asterisks or underscores for italics, and numbers for numbered lists.<\/p>\n

Sadly, Quick Look, when applied to a Markdown file, only shows the file as plain text. I put an example screenshot in the shownotes of a recent Security Bits file in Markdown. The text is a tiny, monospaced font, all of the Markdown is showing, and the indents look all wrong.<\/p>\n

\"Security
Security Bits Markdown in Quick Look<\/figcaption><\/figure>\n

I\u2019d never thought to see if there was a solution to this. But then a came across Thread conversation where someone who goes by the name @piero_sierra wrote,<\/a><\/p>\n

\n Hey @apple<\/a> can we get Preview to render .MDs? k tx bye\n<\/p><\/blockquote>\n

Several people chimed in with solutions, but the one that caught my eye was by our friend Mike Rose, who pointed to Marked QL written by another friend, Brett Terpstra<\/a>. Marked QL is an instant Markdown preview in Quick Look. The installation goes as follows:<\/p>\n

    \n
  1. Install the app<\/li>\n
  2. Use the spacebar to Quick Look Markdown files<\/li>\n<\/ol>\n

    That\u2019s literally it.<\/p>\n

    \"Security
    The Same File in Quick Look with Marked QL<\/figcaption><\/figure>\n

    I put a screenshot in the shownotes showing off how beautiful and, more importantly, readable<\/em> Security Bits looks in Quick Look after installing Marked QL. There\u2019s a left sidebar with a clickable outline of the headings, and then the main panel is rendered with nicely indented bullets and blue syntax highlighting for links.<\/p>\n

    If we had any math, diagrams, or code in this file, Brett promises that would be rendered nicely as well. As soon as I wrote that sentence for the shownotes, I knew I needed to at least test that claim with a Mermaid diagram. These diagrams are created with plain text, and it\u2019s pretty arcane and difficult to follow if you don\u2019t know the language’s conventions. In Quick Look without Marked QL, you just see text like B \u2014> |Daytime| C[Living Room Scene]<\/code>.<\/p>\n

    \"Mermaid
    Example Mermaid Diagram in Quick Look<\/figcaption><\/figure>\n

    But with Marked QL, the diagram is rendered as a flow diagram with arrows, just like any other proper diagram. In the screenshot I included, you can see a purple box with the words “Living Room Scene” and an arrow going to it with the word “Daytime” over the line. It looks fabulous.<\/p>\n

    \"Mermaid
    Look How Pretty Mermaid is with Marked QL<\/figcaption><\/figure>\n

    If you open Marked QL, the only thing you\u2019ll see is the settings window with options to set the Apex Mode (which is Brett\u2019s own unified Markdown engine) and some fancy things I don\u2019t understand like the ability to toggle on Enable Quarto support, add custom styles and change which preview style you like. The default is GitHub (which is what I\u2019ve been using) but there are 9 other styles to choose from.<\/p>\n

    On the Preview tab of Settings, you\u2019ll find way more options \u2014 in fact, I had to use a scrolling screenshot to capture them all. I like seeing the table of contents and the syntax highlighting, but you can toggle either of those off. You can even toggle off Mermaid diagrams, but I can\u2019t imagine wanting to do that! By default, the size of the text and images is fixed, but there\u2019s a toggle to scale the preview with the window size.<\/p>\n

    Here’s another problem Marked QL solves, at least for me. Bart writes the Security Bits and Programming By Stealth shownotes in Markdown, but he uses the application Obsidian to create his Markdown and organize his files. This tool adds a bunch of so-called front matter to the file which it uses for that organization. Obviously very useful for him, but when I get the Markdown file, it has a whole bunch of lines at the top that are purely visual noise. With Marked QL, by default it hides the front matter, which is glorious. If you do want to see the front matter, Marked QL can present it as a code block, or a nicely formatted table.<\/p>\n

    I also want to draw your attention to a section at the bottom, where you can pre-grant permission to images stored on your Desktop, Documents, and Downloads folders. You don’t have to check these boxes, but if you have a Markdown file that calls embedded images from a local folder, you’ll be prompted to grant those permissions. I thought that was a nice little touch by Brett.<\/p>\n

    \"Marked
    So Many Settings in Marked QL<\/figcaption><\/figure>\n

    If you want to test out Marked QL, you can download a free trial from markedapp.com\/\u2026<\/a>. When you decide you can\u2019t live without it, you can buy it in the App Store for $9.99<\/a>, or it\u2019s available in Setapp<\/a>.<\/p>\n

    If $10 is too steep for you and you don’t have a Setapp subscription, follow the link to the Threads conversation to see other open source suggestions to solve the same problem.<\/p>\n

    It makes sense that Brett would be the one to solve this (and elegantly at that), since he\u2019s the author of the app Marked<\/a>. This Mac app is a standalone preview app for your Markdown documents with advanced proofreading tools, beautiful themes, and powerful export options.<\/p>\n

    Thanks to Brett for solving the problem and to Mike Rose for telling us about it.<\/p>\n","protected":false},"excerpt":{"rendered":"

    If you\u2019ve been using a Mac for a while, you know that you can tap the space bar with any file selected to invoke Quick Look, the built-in previewing app for files. Image files show the images, music plays, videos play, PDFs render, presentation and word processing files render nicely, and plain text files render […]<\/p>\n","protected":false},"author":1,"featured_media":36585,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[147],"tags":[7660,256,5322,8398,6822,8399],"class_list":["post-36581","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog-posts","tag-brett-terpstra","tag-markdown","tag-marked","tag-marked-ql","tag-quicklook","tag-ttscoff"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/www.podfeet.com\/blog\/wp-content\/uploads\/2026\/09\/Mermaid-diagram-in-Markdown-file-rendered-by-Marked-QL-1040x520-1.png","_links":{"self":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts\/36581","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/comments?post=36581"}],"version-history":[{"count":5,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts\/36581\/revisions"}],"predecessor-version":[{"id":36588,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts\/36581\/revisions\/36588"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/media\/36585"}],"wp:attachment":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/media?parent=36581"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/categories?post=36581"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/tags?post=36581"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}