Download this page as .mdz

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 .mdz files directly, including internal links and packaged assets.
  • The packager turns a local folder into an .mdz archive 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:

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.