Now on Mac Too

MDZip Studio

A lightweight Markdown editor with native .mdz support, built on the same editor as the browser demo.

Also on WinGet, Chocolatey and Homebrew

Download this page as .mdz

MDZip Studio with the file pane open: one .mdz file holding the document, its manifest, README, AGENTS file and image, with the Markdown source beside a live preview of a Mermaid diagram and a chart

MDZip Studio is...

  • A reference application demonstrating native .mdz create and view workflows
  • A simple, performant Markdown editor — even if you don't need .mdz files
  • Available today for Windows, macOS and Linux (Electron + web)

MDZip Studio is NOT...

  • Meant to be a replacement for your favorite Markdown editor (unless you need .mdz support until your editor supports it)
  • A knowledge base system — there are plenty of those already
  • A full word processor — there are plenty of those already
  • Super minimalist, it has buttons but just the useful ones.

Your images stay with the document

Paste an image into a plain .md file and Studio asks where it should go: beside the file, in a subfolder, or inside the document with Convert to .mdz. Choose that, and the document and its images become one .mdz file you can email, upload or archive without the pictures going missing.

Studio's Add Image dialog after pasting an image into a Markdown file: put the file in the same folder, put it in a subfolder, or convert to .mdz to embed the image in a portable MDZip document

Install

All downloads are on the latest release page. Want to try it first? The Editor Demo runs the same editor in your browser, with nothing to install.

Windows

Download MDZip-Studio-Setup-<version>.exe, or the portable MDZip-Studio-<version>-portable.exe.

Edge's warning that MDZip-Studio-Setup isn't commonly downloaded, with the Keep anyway option open under the Delete button

The app isn't signed with a certificate Windows recognizes, so your browser may warn that the file isn't commonly downloaded. In Microsoft Edge, click the arrow next to Delete and choose Keep anyway, as shown here.

Then, the first time you run it, Windows may say Windows protected your PC. Click More info, then Run anyway. You only do this once. Installing with Chocolatey doesn't show these warnings, and WinGet usually doesn't either.

  • Installer: installing for all users also registers the .mdz file type and adds a File Explorer preview for .mdz files. The first install can take a few minutes with no visible progress while it sets up a required system component; let it finish rather than cancel it.

  • Portable: a single .exe that runs without installing and keeps its settings in a folder beside it. It doesn't register the file type or add the preview.

  • WinGet: installs it for you only (the app only):

    winget install MDZip.Studio
    

    To install it for all users, with the File Explorer preview:

    winget install MDZip.Studio --scope machine
    
  • Chocolatey: installs it for all users, with the File Explorer preview. Run it from PowerShell opened with Run as administrator. The first install can sit at "Installing mdzip-studio..." for several minutes while it sets up the .NET runtime the preview needs; let it finish.

    choco install mdzip-studio
    

    To install the app only:

    choco install mdzip-studio --params "/NoExplorerIntegration"
    

macOS

Download MDZip-Studio-<version>-universal.dmg. It runs on Apple Silicon and Intel Macs (macOS 12 or later). Open it and drag MDZip Studio to Applications; double-clicking an .mdz then opens it in Studio.

The app isn't signed by Apple, so the first time you open it macOS says it couldn't verify it. Click Done.

Then open System Settings → Privacy & Security, scroll down to Security and click Open Anyway next to the message about MDZip Studio. You only do this once.

macOS's message that MDZip Studio wasn't opened because Apple couldn't verify it, with Move to Trash and Done buttons The Security section of Privacy & Security, saying MDZip Studio was blocked to protect your Mac, with the Open Anyway button beside it

Or install it with Homebrew (the same first-launch step applies):

brew install --cask mdzip-project/mdzip/mdzip-studio

To update: brew upgrade --cask mdzip-studio.

Linux

The script below installs the latest version. On Debian, Ubuntu and distributions based on them (Mint, Pop!_OS and others) it installs the .deb; on other distributions it installs the AppImage in ~/Applications with an app menu entry. Either way it registers the .mdz file type. You can read the script first, or download the .deb or AppImage yourself.

curl -fsSL https://mdzip.org/install.sh | sh

Check your download

Each release lists the SHA-256 checksum of every download in SHA256SUMS.txt, on the release page. To check that a file you downloaded is complete and matches the release, work out its checksum and compare it with that file's line (capitals don't matter):

  • Windows (PowerShell): Get-FileHash .\MDZip-Studio-Setup-<version>.exe
  • macOS: shasum -a 256 MDZip-Studio-<version>-universal.dmg
  • Linux: sha256sum MDZip-Studio-<version>.AppImage

The Linux install script, WinGet, Chocolatey and Homebrew check what they download for you.

Markdown support

  • Editing: CommonMark-based Markdown editing through CodeMirror's @codemirror/lang-markdown support.
  • Preview/rendering: GitHub Flavored Markdown-style rendering through marked with its default GFM mode enabled.
  • Safety: Rendered HTML is sanitized with DOMPurify before display.
  • Code blocks: Fenced code blocks are highlighted with highlight.js when a language is recognized.
  • Diagrams: Mermaid code blocks render inline in the preview.
  • Footnotes and task lists render in the preview.

Studio's preview mode showing a table of feeding ratios, a checklist with two items ticked, and a tip

Features

  • Single document .md and .mdz editing (CommonMark)
  • Convert an .md file to .mdz on demand (e.g. when inserting an image)
  • Basic Markdown formatting controls
  • Image support (images are archived inside the .mdz)
  • Source, preview, and split view modes
  • Drag and drop file rearranging within the archive
  • Archive validation
  • Manifest editing
  • Folder packing
  • Recent files
  • Manual and background update checks
  • Print, with a paginated preview — save to PDF via the system print dialog
  • Light, dark, or system color scheme and a choice of page width, both remembered
  • Copy as plain text, formatted text (images included, for Word or email), HTML, or Markdown
  • Remote images load only while View → Load Remote Images is on
  • Large documents with thousands of images open in seconds
  • Windows File Explorer integration (.mdz preview + file-type registration)
  • Portable Windows version: a single .exe that runs without installing
  • Linux packaging (.deb and AppImage), with the .deb registering the .mdz file type
  • One-line Linux install script that picks the .deb or AppImage for your distribution
  • macOS app for Apple Silicon and Intel Macs that opens .mdz files from Finder, also on Homebrew

Planned features

  • Conversion to and from other formats via Pandoc
  • Table formatting controls
  • Plug-in system to use other renderers (draw.io, etc.)
  • More saved preferences (editor configuration etc.)
  • Templates
  • Quick Look preview of .mdz files in Finder (macOS)

Out of scope

  • WYSIWYG editing
  • Tabbed or docked layouts (each document opens in its own window)
  • File manager

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