Official tools for .mdz
The format is open; these tools make it practical day-to-day. Apps for everyone come first — if you build software, the developer libraries are at the end. To check at a glance whether MDZip works with what you use, see Works with MDZip.
Apps
MDZip Studio — the desktop app
Create, edit, and package .mdz archives with a full workspace editor — no command line required. On Windows, installing for all users also registers the .mdz file type and the File Explorer preview; the macOS app registers the .mdz file type, and the Linux .deb registers the .mdz file type too (Debian, Ubuntu and distros based on them, such as Mint), and an AppImage covers other distros.
Get it: download the latest release (Windows installer or portable .exe, macOS .dmg, or Linux .deb/AppImage), or learn more about Studio first. The portable .exe runs without installing and keeps its settings in a folder beside it; it doesn't register the .mdz file type or add the File Explorer preview.
Windows (WinGet):
winget install MDZip.Studio
The default WinGet install is per-user and installs the app only. To install for all users and also get the File Explorer preview, add --scope machine:
winget install MDZip.Studio --scope machine
Windows (Chocolatey), for all users with the File Explorer preview:
choco install mdzip-studio
macOS (Homebrew). The app isn't signed by Apple, so the first launch needs one extra step; the Studio page has it:
brew install --cask mdzip-project/mdzip/mdzip-studio
Linux, any distribution (the .deb on Debian, Ubuntu and distros based on them, the AppImage elsewhere; read the script):
curl -fsSL https://mdzip.org/install.sh | sh
mdz — the command line
Create, inspect, and validate archives from the command line: mdz create, mdz ls, mdz validate, plus cat, assets, manifest, and workspace for deeper work. Self-contained builds for Windows, macOS, and Linux — no runtime to install.
Windows (WinGet):
winget install MDZip.Cli
Windows (PowerShell):
irm https://raw.githubusercontent.com/mdzip-project/mdzip-cli/main/scripts/install.ps1 | iex
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/mdzip-project/mdzip-cli/main/scripts/install.sh | sh
Source and releases: mdzip-project/mdzip-cli.
MDZip Editor for VS Code
Read and write .mdz archives directly in VS Code, including packaged images, split preview/edit mode, and an included MCP server for agent workflows.
Install it from the VS Code Marketplace, search for MDZip in the Extensions view, or install from the terminal:
code --install-extension mdzip-project.mdzip-vscode
Using VSCodium, Cursor or another editor built on VS Code? The extension is on Open VSX too: search for MDZip in that editor's Extensions view.
Learn more about the extension · Source: mdzip-project/mdzip-vscode
MDZip for Obsidian
Open and edit .mdz files in Obsidian's own editor, keep the images you paste inside the note, work with archives that hold many documents, and see them in graph view and search.
Install it from Obsidian's Community plugins: in Obsidian, open Settings → Community plugins, choose Browse and search for MDZip. It works on desktop and mobile, with Obsidian 1.14.5 or later.
Learn more about the plugin · Source: mdzip-project/mdzip-obsidian
Google Voice Chat Exporter
Save a Google Voice conversation, with every message, sender, timestamp and photo, as one .mdz file. It's a userscript: it runs in Chrome, Edge or Firefox on the Google Voice page you already have open, with a userscript manager such as Violentmonkey or Tampermonkey.
Learn more and install it · Source: mdzip-project/mdzip-google-voice-exporter
File Explorer preview (Windows)
Native File Explorer preview for .mdz files, so recipients can inspect packaged content without extracting anything. It ships with MDZip Studio when you install it for all users (the installer's all-users option, or the all-users WinGet or Chocolatey command above) — nothing extra to set up. This preview pane is Windows-only for now; macOS and Linux file-manager preview are still planned (Linux's .deb install registers the .mdz file type, just without a preview pane yet).
Right here, in your browser
No install at all:
- The web previewer opens and renders
.mdzfiles directly, including internal links and packaged assets. - The packager turns a local folder into an
.mdzarchive in the browser — drop a folder, download the archive.
Platform support
| Tool | Windows | macOS | Linux | Notes |
|---|---|---|---|---|
| MDZip Studio | ✅ Available (installer / portable) | ✅ Available (.dmg) |
✅ Available (.deb / AppImage) |
Windows (all-users install), macOS and Linux installs register .mdz; only Windows has the File Explorer preview. Also on WinGet (MDZip.Studio), Chocolatey (mdzip-studio) and Homebrew (mdzip-project/mdzip/mdzip-studio) |
mdz CLI |
✅ Available | ✅ Available | ✅ Available | Also on WinGet (MDZip.Cli) |
| VS Code extension | ✅ Available | ✅ Available | ✅ Available | Marketplace listing; Open VSX listing for VSCodium, Cursor and similar |
| Obsidian plugin | ✅ Available | ✅ Available | ✅ Available | Also on mobile; Obsidian 1.14.5 or later; Community plugins listing |
| Google Voice exporter | ✅ Available | ✅ Available | ✅ Available | Desktop Chrome, Edge or Firefox with a userscript manager |
| Native file-manager preview | ✅ Available (File Explorer) | Planned | Planned | Ships with an all-users Studio install |
| Web previewer & packager | ✅ | ✅ | ✅ | Any modern browser |
For developers
Everything above is built on the JavaScript and .NET libraries below; the Rust and Python libraries read and write the same files. Use any of them to add .mdz support to your own apps. Just want to use .mdz? You're done; everything you need is above.
JavaScript / TypeScript (npm)
@mdzip/core-js — the core: pack, unpack, validate, and resolve .mdz archives in Node or the browser.
npm install @mdzip/core-js
@mdzip/editor — the embeddable workspace editor used by Studio, the VS Code extension, and this site. Use it from vanilla JavaScript or through a first-class framework wrapper:
@mdzip/editor— JavaScript / TypeScript@mdzip/editor-ng— Angular@mdzip/editor-vue— Vue@mdzip/editor-react— React
See it live — the demo exercises all four.
npm install @mdzip/editor
Source: mdzip-project/mdzip-core-js · mdzip-project/mdzip-editor
.NET (NuGet)
MDZip.Core — the C#/.NET core library behind the mdz CLI: read, inspect, validate, edit, and package archives from .NET 8 or .NET 10.
dotnet add package MDZip.Core
Renamed from mdzip-core (the old package is still up but no longer updated — switch to MDZip.Core).
Source: mdzip-project/mdzip-core
Rust (crates.io)
mdzip-core — the Rust core library: read, inspect, validate, edit, and package archives from Rust 1.85 or later, with small pure-Rust dependencies.
cargo add mdzip-core
Source: mdzip-project/mdzip-core-rust · API docs
Python (PyPI)
mdzip-core — the Python core library: read, inspect, validate, edit, and package archives from Python 3.10 or later, using only the standard library. Import it as mdzip_core.
pip install mdzip-core
Source: mdzip-project/mdzip-core-python
Format details
These tools implement the MDZip specification — read it for the normative format rules, or try the editor to see the format in action.
This page renders from tools.mdz (MDZip, ~86 KB, updated 2026-11-10) — one self-contained file. Download it, open it in the web editor, or read how these pages are made.