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
.mdzand adds a File Explorer preview. On macOS and Linux, Studio registers.mdztoo. - The VS Code extension on Windows, macOS and Linux.
- The web editor in any modern browser, with nothing to install.
- The
mdzcommand 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
.mdzfile 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
.mdfiles 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
.mdzand adds the File Explorer preview. From the command line, either of these does that:winget install MDZip.Studio --scope machinechoco install mdzip-studioOn Linux, installing Studio registers
.mdztoo:curl -fsSL https://mdzip.org/install.sh | shOn macOS, Studio registers
.mdztoo. Download the.dmgor use Homebrew:brew install --cask mdzip-project/mdzip/mdzip-studioThe 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
- Right-click any
.mdzfile in File Explorer. - Choose Open with → Choose another app.
- Select your ZIP tool, or browse to its program file.
- Check Always use this app to open .mdz files.
- Click OK.
macOS
Option A: Finder
- Right-click (or Control-click) any
.mdzfile in Finder. - Choose Open With → Other…
- Select Archive Utility (in
/System/Library/CoreServices/Applications/) or The Unarchiver. - Check Always Open With.
- 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
- Right-click any
.mdzfile in your file manager (Files/Nautilus, Thunar, Dolphin, and so on). - Choose Properties → Open With.
- Select your archive manager (File Roller, Ark, Engrampa).
- 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 pressCtrl+Shift+V(Cmd+Shift+Von macOS) to preview it. With the MDZip extension you can skip extracting and open the.mdzitself. - 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:
- Put your Markdown file (named
index.md, ideally) and its images in a folder, with the images in a subfolder such asimages/. - Select the contents of the folder, not the folder itself, and compress them to a
.zipfile. The Markdown file has to be at the top level of the archive. - Rename the
.zipfile 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
.mdzfile and how tools find the document to open. - Tools: MDZip Studio, the VS Code extension, the
mdzcommand line, the browser tools, and developer libraries. - Specification: the complete rules, including the
manifest.jsonfields 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.