
MDZip Studio is...
- A reference application demonstrating native
.mdzcreate and view workflows - A simple, performant Markdown editor — even if you don't need
.mdzfiles - 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
.mdzsupport 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.

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.
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
.mdzfile type and adds a File Explorer preview for.mdzfiles. 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
.exethat 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.StudioTo install it for all users, with the File Explorer preview:
winget install MDZip.Studio --scope machineChocolatey: 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-studioTo 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.

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-markdownsupport. - Preview/rendering: GitHub Flavored Markdown-style rendering through
markedwith its default GFM mode enabled. - Safety: Rendered HTML is sanitized with DOMPurify before display.
- Code blocks: Fenced code blocks are highlighted with
highlight.jswhen a language is recognized. - Diagrams: Mermaid code blocks render inline in the preview.
- Footnotes and task lists render in the preview.

Features
- Single document
.mdand.mdzediting (CommonMark) - Convert an
.mdfile to.mdzon 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 (
.mdzpreview + file-type registration) - Portable Windows version: a single
.exethat runs without installing - Linux packaging (
.deband AppImage), with the.debregistering the.mdzfile type - One-line Linux install script that picks the
.debor AppImage for your distribution - macOS app for Apple Silicon and Intel Macs that opens
.mdzfiles 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
.mdzfiles 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.