<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>MDZip news</title>
    <link>https://mdzip.org/news/index.html</link>
    <description>News from the MDZip project: releases of the .mdz specification, MDZip Studio, the VS Code extension, the Obsidian plugin and the libraries, plus updates and articles.</description>
    <language>en</language>
    <atom:link href="https://mdzip.org/feed.xml" rel="self" type="application/rss+xml" />
    <lastBuildDate>Tue, 10 Nov 2026 00:00:00 GMT</lastBuildDate>
    <item>
      <title>MDZip Studio is now on Mac</title>
      <link>https://mdzip.org/news/2026-11-10-mdzip-studio-is-now-on-mac.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-11-10-mdzip-studio-is-now-on-mac.html</guid>
      <pubDate>Tue, 10 Nov 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/16</comments>
      <description>MDZip Studio 1.7.0 runs on macOS: one download for Apple Silicon and Intel Macs, also on Homebrew. Double-click an .mdz in Finder to open it.</description>
      <content:encoded><![CDATA[<p align="center">
<img src="https://mdzip.org/assets/page-images/a8c9b2115ec7.png" alt="The MDZip mark, an arrow, and the title bar of MDZip Studio on a Mac" width="420" height="180">
</p>

<p>MDZip Studio now runs on Mac. Version 1.7.0 adds one download for Apple Silicon and Intel Macs, and it&#39;s on Homebrew too. Studio is a free, open-source Markdown editor that saves a document and its images in one MDZip (<code>.mdz</code>) file, so the pictures don&#39;t go missing when you email, upload or archive it. Until now it was only for Windows and Linux.</p>
<h2 id="install">Install</h2>
<p><a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-studio/releases/latest">Download <code>MDZip-Studio-1.7.0-universal.dmg</code></a>, open it and drag <strong>MDZip Studio</strong> to <strong>Applications</strong>. It needs macOS 12 or later. Or install it with Homebrew:</p>
<pre><code class="language-bash">brew install --cask mdzip-project/mdzip/mdzip-studio
</code></pre>
<p>Studio isn&#39;t signed by Apple, because signing needs a paid Apple developer account. So the first time you open it, macOS says it couldn&#39;t verify the app. Click <strong>Done</strong>, then open <strong>System Settings → Privacy &amp; Security</strong> and click <strong>Open Anyway</strong>. You only do this once. The <a target="_blank" rel="noopener" href="https://mdzip.org/studio#macos">Studio page</a> has the steps too.</p>
<h2 id="what-you-get-on-mac">What you get on Mac</h2>
<ul>
<li><strong><code>.mdz</code> files open from Finder.</strong> Double-click one and it opens in Studio, with its own document icon. For <code>.md</code> files, Studio is listed under <strong>Open With</strong> but doesn&#39;t take over as the default.</li>
<li><strong>Mac menus and shortcuts.</strong> An <strong>MDZip Studio</strong> menu with About, Check for Updates and Quit, a <strong>Window</strong> menu, <strong>Reveal in Finder</strong>, and <code>⌘</code> shortcuts throughout.</li>
<li><strong>The Dock.</strong> Drop files on Studio&#39;s Dock icon to open them. Its menu starts a new document and lists your recent ones.</li>
<li><strong>Everything else from Windows and Linux:</strong> source, preview and split view; pasted and dragged-in images stored inside the document; Mermaid diagrams, footnotes and task lists; print and save as PDF; copy as formatted text, images included, for Word or email.</li>
<li><strong>Updates.</strong> <strong>Check for Updates</strong> downloads the new version for you to drag to Applications. With Homebrew, run <code>brew upgrade --cask mdzip-studio</code>.</li>
</ul>
<p>Not on Mac yet: previewing an <code>.mdz</code> in Finder with Quick Look, the way Windows previews it in File Explorer.</p>
<h2 id="tell-us-how-it-goes">Tell us how it goes</h2>
<p>Studio has been tested on Apple Silicon. If you&#39;re on an Intel Mac, the 20-minute <a target="_blank" rel="noopener" href="https://mdzip.org/testing-studio-macos.html">test script</a> walks you through everything, and a short form takes your results. Anything else that doesn&#39;t work as you&#39;d expect on a Mac: <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-studio/issues">open an issue</a> or reply here.</p>
<p><a target="_blank" rel="noopener" href="https://mdzip.org/studio">MDZip Studio</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-studio/releases/tag/v1.7.0">Release notes for 1.7.0</a> · <a target="_blank" rel="noopener" href="https://mdzip.org/apps">Everything that works with MDZip</a></p>
<p><sub>Mac and macOS are trademarks of Apple Inc. MDZip isn&#39;t affiliated with or endorsed by Apple.</sub></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>MDZip on mobile: libraries for Android and iOS</title>
      <link>https://mdzip.org/news/2026-11-07-mdzip-on-mobile-libraries-for-android-and-ios.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-11-07-mdzip-on-mobile-libraries-for-android-and-ios.html</guid>
      <pubDate>Sat, 07 Nov 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/15</comments>
      <description>Two new MDZip core libraries bring .mdz to phones: org.mdzip:mdzip-core for Android (Kotlin and Java) and mdzip-core-swift for iOS (Swift). Both pass the same shared conformance tests as the other MDZip libraries.</description>
      <content:encoded><![CDATA[<p align="center">
<img src="https://mdzip.org/assets/page-images/6753ab1a6147.png" alt="Kotlin and Swift logos and the MDZip mark" width="420" height="180">
</p>

<p>MDZip (<code>.mdz</code>) now has native libraries for both phone platforms. <a target="_blank" rel="noopener" href="https://central.sonatype.com/artifact/org.mdzip/mdzip-core"><code>org.mdzip:mdzip-core</code></a> is for <strong>Android</strong> (Kotlin or Java), and <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-swift"><code>mdzip-core-swift</code></a> is for <strong>iOS</strong> (Swift). Both read, write and validate <code>.mdz</code> files, and both pass the same shared conformance tests from the <a target="_blank" rel="noopener" href="https://mdzip.org/spec">specification</a> as the .NET, JavaScript, Python, Rust and Lua libraries. A document saved on a phone opens the same way in MDZip Studio, VS Code or Obsidian, and the other way round.</p>
<h2 id="android">Android</h2>
<p>For Android 5.0 and later. It&#39;s a plain Kotlin library, so it also works in desktop and server apps on Java 8 and later, from Kotlin or Java. No dependencies beyond the Kotlin standard library.</p>
<pre><code class="language-kotlin">dependencies {
    implementation(&quot;org.mdzip:mdzip-core:0.1.0&quot;)
}
</code></pre>
<pre><code class="language-kotlin">// A file the user picked, opened through the ContentResolver.
val archive = contentResolver.openInputStream(uri)!!.use { MdzArchive.open(it) }
val markdown = archive.readText(archive.entryPoint())     // index.md
val photo = archive.readBytes(&quot;images/beach.png&quot;)
</code></pre>
<h2 id="ios">iOS</h2>
<p>For iPhone and iPad on iOS 15 and later. The same package works in Mac apps (macOS 12 and later) and on Linux, so one codebase can handle <code>.mdz</code> on every Apple device. Add it in Xcode under <strong>File → Add Package Dependencies…</strong> with <code>https://github.com/mdzip-project/mdzip-core-swift</code>, or in <code>Package.swift</code>:</p>
<pre><code class="language-swift">.package(url: &quot;https://github.com/mdzip-project/mdzip-core-swift.git&quot;, from: &quot;0.1.0&quot;)
</code></pre>
<pre><code class="language-swift">import MDZip

let archive = try MDZipArchive(contentsOf: url)           // a file from the document picker
let markdown = try archive.text(at: try archive.entryPoint())
let photo = try archive.data(at: &quot;images/beach.png&quot;)
</code></pre>
<h2 id="what-they-do">What they do</h2>
<ul>
<li><strong>Open what people share.</strong> An <code>.mdz</code> is one file with the Markdown and its images together, so it survives email, messaging apps, AirDrop and cloud drives. The libraries read it straight from memory or a stream, without unzipping anything to storage.</li>
<li><strong>Write conforming files.</strong> Every archive gets the <code>manifest.json</code> the specification requires, with the main document recorded, so other tools open the right file.</li>
<li><strong>Change files safely.</strong> Updating an archive keeps everything you didn&#39;t touch, including images, files your app doesn&#39;t know about and manifest fields other apps wrote. If the change would break the archive, nothing is written.</li>
<li><strong>Open untrusted files safely.</strong> Unsafe paths, ZIP bombs and symbolic links are rejected or ignored, with a stable error code your app can check.</li>
</ul>
<p>The libraries don&#39;t render Markdown; your app shows it with the Markdown view it already uses.</p>
<p>Tested on every change: on Android 5.0, 7.0, 10 and 15 emulators and Java 11 and 17 for the Kotlin library, and in the iOS Simulator, on macOS and on Linux for the Swift one.</p>
<h2 id="whats-next">What&#39;s next</h2>
<p>If you&#39;re adding <code>.mdz</code> to an app, <a target="_blank" rel="noopener" href="https://mdzip.org/core-libraries">Core libraries</a> compares all seven, and <a target="_blank" rel="noopener" href="https://mdzip.org/apps">Works with MDZip</a> shows everything that reads and writes it today. Building something on a phone? Tell us in <a target="_blank" rel="noopener" href="https://github.com/orgs/mdzip-project/discussions">Discussions</a>; we&#39;d like to list it.</p>
<p><a target="_blank" rel="noopener" href="https://central.sonatype.com/artifact/org.mdzip/mdzip-core">Android library on Maven Central</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-kotlin">Android source and API reference</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-swift">iOS library source and API reference</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-kotlin/releases/tag/v0.1.0">Release notes: Android</a>, <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-swift/releases/tag/v0.1.0">iOS</a></p>
<p><sub>Kotlin is a trademark of JetBrains s.r.o. Swift and the Swift logo are trademarks of Apple Inc. Neither is affiliated with or endorses MDZip.</sub></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>Lua library for MDZip: pure Lua, no dependencies</title>
      <link>https://mdzip.org/news/2026-11-06-lua-library-for-mdzip-pure-lua-no-dependencies.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-11-06-lua-library-for-mdzip-pure-lua-no-dependencies.html</guid>
      <pubDate>Fri, 06 Nov 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/14</comments>
      <description>mdzip-core-lua is out on LuaRocks: read, write and validate .mdz files in pure Lua 5.3 or 5.4, with no C modules and no dependencies. It passes the same shared conformance tests as the other four MDZip core libraries.</description>
      <content:encoded><![CDATA[<p align="center">
<img src="https://mdzip.org/assets/page-images/fb2d4056cdcf.png" alt="Lua logo and the MDZip mark" width="420" height="180">
</p>

<p>MDZip&#39;s fifth core library is for <strong>Lua</strong>. <a target="_blank" rel="noopener" href="https://luarocks.org/modules/mdzip-project/mdzip-core-lua"><code>mdzip-core-lua</code></a> reads, writes and validates <code>.mdz</code> files, and passes the same shared conformance tests from the <a target="_blank" rel="noopener" href="https://mdzip.org/spec">specification</a> as the .NET, JavaScript, Python and Rust libraries. A file written in Lua opens the same way in every other MDZip tool.</p>
<pre><code>luarocks install mdzip-core-lua
</code></pre>
<pre><code class="language-lua">local mdzip = require(&quot;mdzip&quot;)

assert(mdzip.create_file(&quot;trip.mdz&quot;, {
  files = {
    { path = &quot;index.md&quot;, text = &quot;# Trip notes\n\n![Beach](images/beach.png)\n&quot; },
    { path = &quot;images/beach.png&quot;, data = png },
  },
}))

local archive = assert(mdzip.open_file(&quot;trip.mdz&quot;))
local text = assert(archive:read_text(assert(archive:entry_point())))   -- index.md
</code></pre>
<h2 id="pure-lua-nothing-to-compile">Pure Lua, nothing to compile</h2>
<p>The library is plain Lua 5.3 or 5.4 with no C modules and no dependencies. ZIP, DEFLATE, CRC-32, JSON and Unicode normalization are all built in, so it installs the same way on every platform and runs in hosts that can&#39;t load C modules, such as Pandoc&#39;s built-in Lua.</p>
<h2 id="what-it-does">What it does</h2>
<ul>
<li><strong>Write conforming files.</strong> Every archive gets the <code>manifest.json</code> the specification requires, with the main document recorded, so other tools open the right file.</li>
<li><strong>Change files safely.</strong> Updating an archive keeps everything you didn&#39;t touch, including images, files your app doesn&#39;t know about and manifest fields other apps wrote. If the change would break the archive, nothing is written.</li>
<li><strong>Open untrusted files safely.</strong> Unsafe paths, ZIP bombs and symbolic links are rejected or ignored, with a stable error code. Functions that can fail return <code>nil, err</code>, the usual Lua convention.</li>
</ul>
<p>LuaJIT and Lua 5.1, which Neovim and several game engines use, aren&#39;t supported yet.</p>
<h2 id="whats-next">What&#39;s next</h2>
<p>A <a target="_blank" rel="noopener" href="https://pandoc.org">Pandoc</a> reader and writer built on this library is in progress, for converting <code>.mdz</code> to and from Word, EPUB, HTML and the other formats Pandoc supports.</p>
<p>If you&#39;re adding <code>.mdz</code> support to an app, <a target="_blank" rel="noopener" href="https://mdzip.org/core-libraries#lua">Core libraries</a> compares all five, and <a target="_blank" rel="noopener" href="https://mdzip.org/apps">Works with MDZip</a> shows everything that reads and writes it today.</p>
<p><a target="_blank" rel="noopener" href="https://luarocks.org/modules/mdzip-project/mdzip-core-lua">Lua on LuaRocks</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-lua">Source and API reference</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-lua/releases/tag/v0.1.0">Release notes</a></p>
<p><sub>The <a target="_blank" rel="noopener" href="https://www.lua.org/">Lua</a> logo is copyright © 1998 Lua.org, graphic design by Alexandre Nakonechnyj. Lua.org is not affiliated with and does not endorse MDZip.</sub></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>Google Voice exporter is now on Greasy Fork and OpenUserJS</title>
      <link>https://mdzip.org/news/2026-11-03-google-voice-exporter-is-now-on-greasy-fork-and.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-11-03-google-voice-exporter-is-now-on-greasy-fork-and.html</guid>
      <pubDate>Tue, 03 Nov 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/12</comments>
      <description>The Google Voice exporter is on Greasy Fork and OpenUserJS: one-click install, automatic updates. It saves a Google Voice conversation, with its photos, as one .mdz file.</description>
      <content:encoded><![CDATA[<p align="center">
<img src="https://mdzip.org/assets/page-images/f49488c71511.png" alt="MDZip and Google Voice exporter icons" width="420" height="180" />
</p>

<p>The Google Voice exporter is now on <a target="_blank" rel="noopener" href="https://greasyfork.org/en/scripts/603539-google-voice-chat-exporter">Greasy Fork</a> and <a target="_blank" rel="noopener" href="https://openuserjs.org/scripts/kylemwhite/Google_Voice_Chat_Exporter">OpenUserJS</a>, so it installs in one click from your userscript manager and updates on its own. It saves a Google Voice conversation, with its photos, as one MDZip (<code>.mdz</code>) file you can open in MDZip Studio, VS Code, the browser editor or any Markdown viewer.</p>
<p align="center"><img src="https://mdzip.org/assets/page-images/8ac81278447c.png" alt="An exported Google Voice conversation open in MDZip Studio" width="800"></p>

<p>What&#39;s new since the first release:</p>
<ul>
<li>Exporting one year or a date range now covers only that range, and it&#39;s much faster.</li>
<li>Messages you sent are right-aligned, like they are in Google Voice.</li>
<li>Contacts without a photo get round letter avatars that show up in more viewers, including the Windows File Explorer preview.</li>
<li>An export where only you wrote is no longer titled &quot;Unknown Contact&quot;; the names come from the conversation itself.</li>
</ul>
<p><a target="_blank" rel="noopener" href="https://mdzip.org/google-voice">Install steps and how it works</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-google-voice-exporter">Source on GitHub</a></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>MDZip for Obsidian is in Community plugins: keep notes and their images in one file</title>
      <link>https://mdzip.org/news/2026-10-27-mdzip-for-obsidian-is-in-community-plugins-keep.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-10-27-mdzip-for-obsidian-is-in-community-plugins-keep.html</guid>
      <pubDate>Tue, 27 Oct 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/11</comments>
      <description>The MDZip plugin is now in Obsidian's Community plugins, for desktop and mobile. Open and edit .mdz files in Obsidian's own editor, keep pasted images inside the file, and search, link and graph across archives and your notes.</description>
      <content:encoded><![CDATA[<p align="center">
<img  alt="MDZip and Obsidian logos" width="420" height="180" src="https://mdzip.org/assets/page-images/bd8eaf8b3403.png" />
</p>

<p>The MDZip plugin for Obsidian is now in Obsidian&#39;s <a target="_blank" rel="noopener" href="https://community.obsidian.md/plugins/mdzip">Community plugins</a>. In Obsidian, open <strong>Settings → Community plugins</strong>, choose <strong>Browse</strong>, search for <strong>MDZip</strong>, then <strong>Install</strong> and <strong>Enable</strong>. It works on desktop and mobile, with Obsidian 1.14.5 or later.</p>
<p align="center">
<img " alt="An .mdz open in Obsidian, with the MDZip logo and the Archive contents pane" width="800" height="500" src="https://mdzip.org/assets/page-images/5bbbc1340e9c.png" />
</p>

<h2 id="why-mdz-in-obsidian">Why <code>.mdz</code> in Obsidian</h2>
<p>An Obsidian note and its images are separate files, held together by the vault. Send the note to someone, move it to another vault or open it in another app, and the pictures go missing. An <code>.mdz</code> keeps the note and every image it uses in one file, so it travels intact and opens in <a target="_blank" rel="noopener" href="https://mdzip.org/studio">MDZip Studio</a>, <a target="_blank" rel="noopener" href="https://mdzip.org/vscode">VS Code</a>, <a target="_blank" rel="noopener" href="https://mdzip.org/editor.html">your browser</a>, or any ZIP tool.</p>
<h2 id="what-the-plugin-does">What the plugin does</h2>
<ul>
<li><strong>Edit <code>.mdz</code> files in Obsidian&#39;s own editor</strong>, with live preview, reading view and your hotkeys. Changes save back into the file.</li>
<li><strong>Keep pasted images inside the file.</strong> Paste or drop an image and it goes into the <code>.mdz</code>, not a vault folder. Pasting an image into a plain note offers to turn the note into an <code>.mdz</code>.</li>
<li><strong>Work with archives that hold many documents</strong>: a handbook, a trip plan, a small wiki. The Archive contents pane lets you browse, search, add, rename and move documents and folders, and links inside the archive are updated when things move.</li>
<li><strong>Link between your notes and archives.</strong> <code>[Design](Project.mdz/docs/design.md)</code> opens a document inside an archive, and those links follow the archive if you rename or move it.</li>
<li><strong>Search and graph.</strong> MDZip search finds text in every archive in your vault, and graph view shows the documents inside them alongside your notes.</li>
</ul>
<p align="center">
<img alt="MDZip search finding a word across two archives, with the match highlighted in the document" width="800" height="500" src="https://mdzip.org/assets/page-images/4a9069e7eeb5.png" />
</p>

<p>The plugin works only with files in your vault. It makes no network requests and collects nothing.</p>
<p><a target="_blank" rel="noopener" href="https://community.obsidian.md/plugins/mdzip">MDZip in Community plugins</a> · <a target="_blank" rel="noopener" href="https://mdzip.org/obsidian">About the plugin</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-obsidian">Source and issues on GitHub</a></p>
<p><sub>Obsidian is a trademark of Dynalist Inc. MDZip isn&#39;t affiliated with or endorsed by Obsidian.</sub></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>Python and Rust libraries for MDZip: four core libraries, one format</title>
      <link>https://mdzip.org/news/2026-10-26-python-and-rust-libraries-for-mdzip-four-core.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-10-26-python-and-rust-libraries-for-mdzip-four-core.html</guid>
      <pubDate>Mon, 26 Oct 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/10</comments>
      <description>mdzip-core is out for Python (PyPI) and Rust (crates.io). Like the .NET and JavaScript libraries, both pass the specification's shared conformance tests, so every app using them reads and writes the same .mdz files.</description>
      <content:encoded><![CDATA[<p align="center"><img src="https://mdzip.org/assets/page-images/232ac0bb55ab.png" alt=".NET, JavaScript, Python and Rust logos" width="420" height="180"></p>

<p>MDZip now has core libraries for <strong>Python</strong> and <strong>Rust</strong>, alongside the existing ones for .NET and JavaScript. Each one reads, writes and validates <code>.mdz</code> files, and each passes the same shared conformance tests from the <a target="_blank" rel="noopener" href="https://mdzip.org/spec">specification</a>. An app built on any of them reads and writes the same files as every other MDZip tool.</p>
<h2 id="python">Python</h2>
<p><a target="_blank" rel="noopener" href="https://pypi.org/project/mdzip-core/"><code>mdzip-core</code></a> for Python 3.10 and later, using only the standard library.</p>
<pre><code>pip install mdzip-core
</code></pre>
<pre><code class="language-python">import mdzip_core

data = mdzip_core.create({&quot;index.md&quot;: &quot;# Trip notes\n\n![Beach](images/beach.png)\n&quot;, &quot;images/beach.png&quot;: png})
open(&quot;trip.mdz&quot;, &quot;wb&quot;).write(data)

with mdzip_core.open(&quot;trip.mdz&quot;) as archive:
    text = archive.read_text(archive.entry_point)   # index.md
</code></pre>
<h2 id="rust">Rust</h2>
<p><a target="_blank" rel="noopener" href="https://crates.io/crates/mdzip-core"><code>mdzip-core</code></a> for Rust 1.85 and later, with small pure-Rust dependencies. <a target="_blank" rel="noopener" href="https://docs.rs/mdzip-core">API docs</a>.</p>
<pre><code>cargo add mdzip-core
</code></pre>
<pre><code class="language-rust">use mdzip_core::{create, CreateOptions, MdzArchive};

let data = create(
    [(&quot;index.md&quot;, &quot;# Trip notes\n\n![Beach](images/beach.png)\n&quot;.as_bytes()), (&quot;images/beach.png&quot;, png)],
    &amp;CreateOptions::new(),
)?;
std::fs::write(&quot;trip.mdz&quot;, data)?;

let archive = MdzArchive::open_path(&quot;trip.mdz&quot;)?;
let text = archive.read_text(&amp;archive.entry_point()?)?;   // index.md
</code></pre>
<h2 id="what-both-of-them-do">What both of them do</h2>
<ul>
<li><strong>Write conforming files.</strong> Every archive gets the <code>manifest.json</code> the specification requires, with the main document recorded, so other tools open the right file.</li>
<li><strong>Change files safely.</strong> Updating an archive keeps everything you didn&#39;t touch, including images, files your app doesn&#39;t know about and manifest fields other apps wrote.</li>
<li><strong>Open untrusted files safely.</strong> Unsafe paths, ZIP bombs and symbolic links are rejected or ignored, with a stable error code.</li>
</ul>
<h2 id="why-the-shared-tests-matter">Why the shared tests matter</h2>
<p>The specification comes with test files every MDZip library has to pass: tricky entry points, unusual file names, hostile archives, and files that must survive being opened and saved. All four core libraries run them, so a file written in Python opens the same way in the Rust, .NET and JavaScript libraries, and in the apps built on them.</p>
<p>If you&#39;re adding <code>.mdz</code> support to an app, <a target="_blank" rel="noopener" href="https://mdzip.org/docs/integrate.html">Add MDZip to your app</a> has the steps, and <a target="_blank" rel="noopener" href="https://mdzip.org/apps">Works with MDZip</a> shows everything that reads and writes it today.</p>
<p><a target="_blank" rel="noopener" href="https://pypi.org/project/mdzip-core/">Python on PyPI</a> · <a target="_blank" rel="noopener" href="https://crates.io/crates/mdzip-core">Rust on crates.io</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-python">Python source</a> · <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-core-rust">Rust source</a></p>
<p><sub>The .NET logo is a trademark of the .NET Foundation. The JavaScript logo is by Chris Williams, under the MIT License. The Python logo is a trademark of the Python Software Foundation. The Rust logo is by the Rust Foundation, used under <a target="_blank" rel="noopener" href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>. None of these organizations is affiliated with or endorses MDZip.</sub></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>VS Code extension 1.7: now on Open VSX with improved MCP functionality</title>
      <link>https://mdzip.org/news/2026-10-23-vs-code-extension-1-7-now-on-open-vsx-and-ai.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-10-23-vs-code-extension-1-7-now-on-open-vsx-and-ai.html</guid>
      <pubDate>Fri, 23 Oct 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/8</comments>
      <description>MDZip for VS Code 1.7 is on Open VSX for VSCodium, Cursor and other editors built on VS Code. AI agents can now add, replace and remove any file in an .mdz.</description>
      <content:encoded><![CDATA[<img width="1208" height="286" alt="Open VSX Registry" src="https://mdzip.org/assets/page-images/e985ab125180.png" />

<p>Version 1.7 of the MDZip Editor extension is out, and it&#39;s now on <a target="_blank" rel="noopener" href="https://open-vsx.org/extension/mdzip-project/mdzip-vscode">Open VSX</a> as well as the <a target="_blank" rel="noopener" href="https://marketplace.visualstudio.com/items?itemName=mdzip-project.mdzip-vscode">VS Code Marketplace</a>.</p>
<h2 id="on-open-vsx">On Open VSX</h2>
<p>Open VSX is the extension store used by VSCodium, Cursor, Windsurf and other editors built on VS Code. Until now those editors could only install MDZip by downloading the <code>.vsix</code> file from GitHub. Now you can search for <strong>MDZip</strong> in the Extensions view and install it like any other extension, with updates arriving the same way. Your editor needs to be based on VS Code 1.95 or later.</p>
<h2 id="ai-agents-can-change-any-file-in-an-mdz">AI agents can change any file in an <code>.mdz</code></h2>
<p>Until now, the extension&#39;s MCP server let an agent read anything in an archive but change only the main document. Ask it to swap an image and it had to say it couldn&#39;t. Now it can:</p>
<ul>
<li><strong>Add or replace any file</strong>: another document, an image, a diagram, a stylesheet, a data file. The agent can pass the content directly or point at a file it just made, such as a generated chart.</li>
<li><strong>Remove a file.</strong> The main document and the manifest stay put.</li>
<li><strong>Nothing is lost by accident.</strong> Replacing or removing a file is refused if it changed since the agent last read it, every other file in the archive stays exactly as it was, and after each change the agent is told about images nothing uses and links that no longer point anywhere.</li>
</ul>
<p>The new tools work in VS Code&#39;s own chat and in any agent that uses the MCP server, such as Claude Code and Codex.</p>
<p><a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-vscode/releases/tag/v1.7.0">Release notes</a> · <a target="_blank" rel="noopener" href="https://open-vsx.org/extension/mdzip-project/mdzip-vscode">Open VSX listing</a> · <a target="_blank" rel="noopener" href="https://mdzip.org/vscode">About the extension</a></p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>Spec 1.2.0 and new releases across the tools</title>
      <link>https://mdzip.org/news/2026-10-21-spec-1-2-0-and-new-releases-across-the-tools.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-10-21-spec-1-2-0-and-new-releases-across-the-tools.html</guid>
      <pubDate>Wed, 21 Oct 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/7</comments>
      <description>Version 1.2.0 of the MDZip specification is out, and the apps and libraries that read and write .mdz files have new releases that follow it. Archives…</description>
      <content:encoded><![CDATA[<p>Version 1.2.0 of the MDZip specification is out, and the apps and libraries that read and write <code>.mdz</code> files have new releases that follow it. Archives made under 1.1.0 stay valid.</p>
<h2 id="what-changed-in-the-format">What changed in the format</h2>
<ul>
<li>Tools that create an <code>.mdz</code> now always write a <code>manifest.json</code> that names the spec version and the main document. Apps that open one still don&#39;t require it.</li>
<li>An archive can carry an <code>AGENTS.md</code> at its root: instructions that tell AI agents how to handle the archive safely.</li>
<li>Paths inside an archive are case-sensitive, so <code>Images/Logo.png</code> and <code>images/logo.png</code> are different files.</li>
<li>Links can point to files next to an archive and into other archives, in apps that support it, within a trust boundary. Wikilinks and other link styles are allowed.</li>
<li>Apps that save an archive must keep the manifest fields and files they don&#39;t know about.</li>
</ul>
<p>Read the <a target="_blank" rel="noopener" href="https://mdzip.org/spec">specification</a>, or the <a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-spec/blob/v1.2.0/CHANGELOG.md">full list of changes</a>.</p>
<h2 id="mdzip-studio-16">MDZip Studio 1.6</h2>
<ul>
<li><strong>On WinGet:</strong> <code>winget install MDZip.Studio</code>.</li>
<li><strong>A portable version:</strong> one <code>.exe</code> that runs without installing.</li>
<li><strong>Large documents show their images within seconds</strong>, even with thousands of them.</li>
<li><strong>Color scheme and page width menus</strong>, remembered between sessions.</li>
<li><strong>Copy and Copy All</strong> as plain text, formatted text, HTML or Markdown.</li>
<li><strong>View → Load Remote Images</strong> turns <code>https:</code> images off for anyone who doesn&#39;t want documents contacting other servers.</li>
</ul>
<p><a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-studio/releases/tag/v1.6.0">Release notes</a> · <a target="_blank" rel="noopener" href="https://mdzip.org/studio">MDZip Studio</a></p>
<h2 id="vs-code-extension-15">VS Code extension 1.5</h2>
<ul>
<li><strong>Remote images now show</strong>, as in VS Code&#39;s own Markdown preview, with the <code>mdzip.remoteImages</code> setting to turn them off.</li>
<li><strong>Page width, Copy and Copy All menus</strong>, as in Studio.</li>
<li><strong>The color scheme follows your VS Code theme</strong>, and Light or Dark can override it.</li>
</ul>
<p><a target="_blank" rel="noopener" href="https://github.com/mdzip-project/mdzip-vscode/releases/tag/v1.5.0">Release notes</a> · <a target="_blank" rel="noopener" href="https://mdzip.org/vscode">VS Code extension</a></p>
<h2 id="the-mdz-cli-and-the-libraries">The <code>mdz</code> CLI and the libraries</h2>
<ul>
<li><strong><code>mdz</code> 2.0</strong> is on WinGet: <code>winget install MDZip.Cli</code>.</li>
<li><strong><code>@mdzip/core-js</code> 2.0.1</strong> and <strong><code>MDZip.Core</code> 2.0.1</strong> implement spec 1.2.0 for JavaScript and .NET.</li>
<li><strong><code>@mdzip/editor</code> 2.2.0</strong> adds footnotes, task list checkboxes and Mermaid 12 diagrams to every app built on it.</li>
</ul>
<p>See <a target="_blank" rel="noopener" href="https://mdzip.org/tools.html">Tools</a> for downloads.</p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
    <item>
      <title>Announcing MDZip (.mdz) — a portable Markdown bundle format</title>
      <link>https://mdzip.org/news/2026-03-09-announcing-mdzip-mdz-a-portable-markdown-bundle.html</link>
      <guid isPermaLink="true">https://mdzip.org/news/2026-03-09-announcing-mdzip-mdz-a-portable-markdown-bundle.html</guid>
      <pubDate>Mon, 09 Mar 2026 00:00:00 GMT</pubDate>
      <category>Announcement</category>
      <comments>https://github.com/orgs/mdzip-project/discussions/2</comments>
      <description>I'm sharing the first draft of a new open file format spec: MDZip (.mdz).</description>
      <content:encoded><![CDATA[<p>Hi everyone,</p>
<p>I&#39;m sharing the first draft of a new open file format spec: MDZip (.mdz).</p>
<p>The problem it solves: Markdown is great for writing, but sharing a document with images and multiple files means sending a folder, a repo link, zip or a tarball — none of which are friendly to non-technical recipients. .mdz is simply a standard ZIP archive with a (loosly) defined structure — Markdown content, assets, and optional metadata bundled into one portable file. Rename it to .zip and extract, and it works with any existing tool, no special software needed. With appropriate ecosystem support, it becomes useful without renaming/unzipping/zipping.</p>
<h2 id="whats-here-now">What&#39;s here now:</h2>
<ul>
<li>A full draft spec (v1.0.0-draft) — format structure, manifest schema, conformance requirements, implementation guidance, AI agent prompting tips</li>
<li>A companion site at <a target="_blank" rel="noopener" href="https://mdzip.org/">MDZip.org</a> with use cases, a future projects wishlist, and developer resources</li>
</ul>
<h2 id="what-im-looking-for">What I&#39;m looking for:</h2>
<ul>
<li>Feedback on the spec itself — anything unclear, missing, or wrong</li>
<li>Interest in building tools — VS Code extension, Obsidian plugin, CLI, Pandoc reader/writer, native OS preview handlers, and more are all on the wishlist</li>
<li>Real-world use cases I haven&#39;t thought of</li>
</ul>
<p>The spec is CC BY 4.0. Everything is open. If you build something, please share it here.</p>

<hr>
<p><strong>Works with MDZip today:</strong> Windows &middot; Linux &middot; macOS &middot; Web browsers &middot; Command line &middot; ZIP tools &middot; VS Code &middot; VSCodium, Cursor and other editors built on VS Code &middot; AI agents &middot; Obsidian &middot; Google Voice &middot; JavaScript and TypeScript &middot; .NET &middot; Rust &middot; React, Vue and Angular &middot; Python &middot; Lua &middot; Swift &middot; Kotlin and Java. <a href="https://mdzip.org/apps">See the full list</a></p>]]></content:encoded>
    </item>
  </channel>
</rss>
