Download this page as .mdz

Use .mdz today

An .mdz file is an ordinary ZIP archive of Markdown text and the images it uses. You can open one today with an MDZip tool, or with the ZIP and Markdown software already on your computer.

The easiest way: an MDZip tool

These open an .mdz file directly, with its images in place and no extracting:

  • MDZip Studio for Windows, macOS and Linux. On Windows, installing for all users registers .mdz and adds a File Explorer preview. On macOS and Linux, Studio registers .mdz too.
  • The VS Code extension on Windows, macOS and Linux.
  • The web editor in any modern browser, with nothing to install.
  • The mdz command line for creating, inspecting, validating and extracting archives.
  • The Obsidian plugin is coming soon.

Getting Started walks through each of them. The rest of this page is for when you'd rather use what you already have.

Open an .mdz file

An .mdz file is a valid ZIP archive, so any ZIP tool can open it.

Rename and extract

Rename the file from .mdz to .zip, then double-click it to open it in your system's built-in ZIP support. Extract it, and open the entry Markdown file in any text editor or Markdown viewer. The entry file is usually index.md; if the archive has a manifest.json, its entryPoint names it.

Open it without renaming

Most ZIP tools open an .mdz directly. Choose File → Open, set the file picker to "All files", or drag the file into the app window:

  • 7-Zip (Windows): File → Open archive, or right-click the file → 7-Zip → Open archive.
  • NanaZip (Windows): File → Open archive, or right-click the file → NanaZip → Open archive.
  • WinRAR (Windows): File → Open archive.
  • The Unarchiver (macOS): drag the file onto the app icon.
  • GNOME Archive Manager / File Roller (Linux): File → Open.

Note: Reading a file inside a ZIP tool shows you the raw Markdown, but its images and links to other .md files won't work there. For the full document, extract the archive first, then open the entry file in a Markdown viewer — or use one of the MDZip tools, which show it with everything in place.

If your browser or email client warns you about downloading an .mdz file, that's an old, unrelated file type with the same extension. Browser warnings on .mdz explains what's going on and how to get past it.

Register .mdz with your system

Associate the .mdz extension with your ZIP tool, so that double-clicking an .mdz file opens it.

Already installed MDZip Studio? You can skip this. On Windows, installing Studio for all users registers .mdz and adds the File Explorer preview. From the command line, either of these does that:

winget install MDZip.Studio --scope machine
choco install mdzip-studio

On Linux, installing Studio registers .mdz too:

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

On macOS, Studio registers .mdz too. Download the .dmg or use Homebrew:

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

The steps below are for every other case.

Windows

Option A: File Explorer's built-in ZIP support

In Command Prompt, run as Administrator:

assoc .mdz=CompressedFolder

Windows now treats .mdz files as compressed folders and opens them in File Explorer, just like .zip files.

Option B: 7-Zip or NanaZip

In Command Prompt, run as Administrator, for 7-Zip:

assoc .mdz=7-Zip.mdz
ftype 7-Zip.mdz="C:\Program Files\7-Zip\7zFM.exe" "%1"

For NanaZip, use the same pattern with its program path:

assoc .mdz=NanaZip.mdz
ftype NanaZip.mdz="C:\Program Files\NanaZip\NanaZip.exe" "%1"

Adjust the path if 7-Zip or NanaZip is installed somewhere else.

Option C: without the command line

  1. Right-click any .mdz file in File Explorer.
  2. Choose Open with → Choose another app.
  3. Select your ZIP tool, or browse to its program file.
  4. Check Always use this app to open .mdz files.
  5. Click OK.

macOS

Option A: Finder

  1. Right-click (or Control-click) any .mdz file in Finder.
  2. Choose Open With → Other…
  3. Select Archive Utility (in /System/Library/CoreServices/Applications/) or The Unarchiver.
  4. Check Always Open With.
  5. Click Open.

Option B: Terminal, with duti

Install duti with Homebrew, then associate .mdz with your archive app:

# Install duti if you don't have it
brew install duti

# Associate .mdz with Archive Utility
duti -s com.apple.archiveutility .mdz all

# Or with The Unarchiver
duti -s com.macpaw.site.theunarchiver .mdz all

Linux

Option A: your file manager

  1. Right-click any .mdz file in your file manager (Files/Nautilus, Thunar, Dolphin, and so on).
  2. Choose Properties → Open With.
  3. Select your archive manager (File Roller, Ark, Engrampa).
  4. Click Set as default.

Option B: xdg-mime

Register the .mdz MIME type, then make your archive manager its default:

# Register the .mdz MIME type (the same one MDZip Studio's .deb uses)
sudo tee /usr/share/mime/packages/mdz.xml > /dev/null <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
  <mime-type type="application/vnd.mdzip">
    <comment>MDZip Document</comment>
    <glob pattern="*.mdz"/>
  </mime-type>
</mime-info>
EOF

# Update the MIME database
sudo update-mime-database /usr/share/mime

# Make your archive manager the default (GNOME example)
xdg-mime default org.gnome.FileRoller.desktop application/vnd.mdzip

# KDE / Ark example
# xdg-mime default org.kde.ark.desktop application/vnd.mdzip

After this, double-clicking an .mdz file opens it in your archive manager.

Read the Markdown

Once you've extracted an .mdz archive, its contents are plain Markdown and ordinary image files. Any Markdown tool can show them.

Desktop editors

  • VS Code: open the entry file (usually index.md) and press Ctrl+Shift+V (Cmd+Shift+V on macOS) to preview it. With the MDZip extension you can skip extracting and open the .mdz itself.
  • Obsidian: open the extracted folder as a vault.
  • Typora: open the entry file.

Command line

# Render to HTML with Pandoc (use your entry file's name)
pandoc index.md -o index.html

# Read it in the terminal with Glow
glow index.md

Online

Paste the entry file's Markdown into an online Markdown renderer such as Dillinger or Markdown Live Preview. Images won't show this way, because they stay on your computer.

Create an .mdz file

You can make one by hand, with no MDZip software at all:

  1. Put your Markdown file (named index.md, ideally) and its images in a folder, with the images in a subfolder such as images/.
  2. Select the contents of the folder, not the folder itself, and compress them to a .zip file. The Markdown file has to be at the top level of the archive.
  3. Rename the .zip file to .mdz.

That's a valid .mdz file. It needs no manifest.json, although every MDZip tool writes one when it creates an archive. Format Details has the exact rules, and Getting Started shows how to create one with Studio, the browser packager, or mdz create.

Where to go next

  • Format Details: what's inside an .mdz file and how tools find the document to open.
  • Tools: MDZip Studio, the VS Code extension, the mdz command line, the browser tools, and developer libraries.
  • Specification: the complete rules, including the manifest.json fields and the MIME type.
  • Contribute: ways to help build the MDZip ecosystem.

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