Test script: MDZip Studio on Mac

This script checks that MDZip Studio installs and works on your Mac. It takes about 20 minutes. Go through the steps in order. When something looks different from You should see, note the step number and what happened, then carry on if you can.

You'll need: a Mac with macOS 12 or later, Apple Silicon or Intel. If Studio is already installed, drag it from Applications to the Bin first, so you can test installing it.

Write down before you start: your Mac's model and chip, and your macOS version. Both are in Apple menu → About This Mac.

When you're done, post your results.

Install

Open the latest release and download MDZip-Studio-<version>-universal.dmg.

You should see: the .dmg in your Downloads folder.
Double-click the .dmg, then drag MDZip Studio onto Applications in the window that opens.

You should see: MDZip Studio in your Applications folder, with the MDZip icon.
Open MDZip Studio from Applications.

You should see: a message that macOS couldn't verify the app. That's expected, because Studio isn't signed by Apple. Click Done (OK on older macOS).
Open System Settings → Privacy & Security (on macOS 12, System Preferences → Security & Privacy), scroll down and click Open Anyway next to MDZip Studio, then confirm.

You should see: Studio opens. From now on it opens normally, without the message.
Choose MDZip Studio → About MDZip Studio.

You should see: the version number. Write it down for your report.

Open a document from Finder

Quit Studio (⌘Q). Download the sample document (demo-single.mdz).

You should see: in Finder, the file has the MDZip document icon, not a blank page.
Double-click demo-single.mdz.

You should see: Studio opens and shows the document, including its picture.
Switch between the source, split and preview views with the view buttons in the toolbar above the document.

You should see: the Markdown text in source view, the formatted document in preview, and both side by side in split view. The picture shows in preview.

Edit and save

In source or split view, type a new line of text, then save (⌘S).

You should see: no error message. Step 11 checks that it really saved.
Copy a picture to the clipboard: press Control-Shift-⌘-4 and drag over part of the screen. Then click in the document and paste (⌘V).

You should see: the picture appears in the document.
Save, quit Studio, and double-click demo-single.mdz again.

You should see: your new line and the pasted picture are still there.

Mac menus and the Dock

Open each menu at the top of the screen: MDZip Studio, File, Edit, View, Window and Help.

You should see: the menus open, and their items show ⌘ shortcuts.
Choose File → Reveal in Finder.

You should see: a Finder window with demo-single.mdz selected.
Right-click (or Control-click) Studio's icon in the Dock.

You should see: New Markdown Document, New MDZip Document and New Window, and demo-single.mdz among the recent documents.
Choose New MDZip Document from that Dock menu.

You should see: a new, empty document window.
Close every Studio window, then drag demo-single.mdz from Finder onto Studio's Dock icon.

You should see: the document opens.
Choose MDZip Studio → Check for Updates.

You should see: "You're up to date." If a newer version is out, Studio offers to download it instead. You don't need to install it for this test.

Markdown files

Right-click Studio's Dock icon and choose New Markdown Document. Type a line and save it to your Desktop as test.md.

You should see: the file on your Desktop.
In Finder, right-click test.md and open the Open With menu.

You should see: MDZip Studio in the list.

Homebrew (optional)

Skip this part if you don't use Homebrew.

Drag MDZip Studio from Applications to the Bin. Then, in Terminal, run:
```
brew install --cask mdzip-project/mdzip/mdzip-studio
```
You should see: Homebrew installs MDZip Studio into Applications. The first launch still needs Open Anyway, as in step 4.
Open Studio, then double-click demo-single.mdz in Finder.

You should see: the document opens in the Homebrew copy of Studio, just as in step 7.

Post your results

Post a test report and choose MDZip Studio on Mac as the script. Include your Mac's model and chip, your macOS version, Studio's version, and the number of any step that didn't match. A report where every step passed is just as useful.

To tidy up afterwards, delete test.md and demo-single.mdz. Keep Studio if you like it.

This page renders from testing-studio-macos.mdz (MDZip, ~3 KB, updated 2026-11-09) — one self-contained file. Download it, open it in the web editor, or read how these pages are made.