Markdown Diff for VS CodeRead Markdown changes as rendered tables, lists, headings, and text. The extension uses the comparison already open in VS Code. InstallRequires desktop Visual Studio Code 1.85 or newer. Open Markdown Diff on the Visual Studio Marketplace and choose Install, or search for Or install from a terminal:
With Auto Update enabled for Markdown Diff, VS Code obtains new releases from Marketplace. If you previously installed a VSIX, right-click the extension in the Extensions view and enable Auto Update; VSIX installation disables it by default. The extension ID is unchanged, so it remains the same extension. Reload the window if VS Code requests it. For manual/offline installation, download the VSIX, then run Extensions: Install from VSIX... from the Command Palette. Release notes, checksums and older versions remain available; install an older VSIX to roll back. Use
The preview is a snapshot. Refresh reads the same original and modified document URIs again, including unsaved editor text. It preserves the baseline selected by VS Code. It does not select HEAD, stage changes, write files, or follow another tab. The original comparison's label appears above both sides. Unsaved sides are marked. Reopening the same captured snapshot restores its logical reading position and page. Refresh or a new command capture starts a new view. Source is live and can differ from the captured preview. Opening Source reuses the original native comparison when it is still open, or reopens the same URI pair. It does not refresh the preview. When you return, a note identifies text that changed since capture or a source check that could not finish. Choose Refresh to capture the current text. Running Render this comparison again also captures the current text. Source stays available when the rendered comparison fails. Loaded rendered text stays in the document when you scroll away, preserving selection and navigation across the loaded preview. Returning from Source rebuilds the captured comparison. The extension supports ordinary text diff tabs for Images appear as labelled placeholders. This avoids displaying current workspace images as historical content. The rendered view marks changed image attributes. Open live Source to inspect the current Markdown. Only external HTTPS links are active in the preview. Relative links, file links, and command links stay inactive. No document images or remote scripts load. Comparisons run in a cancellable Web Worker. Large tables, lists, and supported code blocks use pages. Precision warnings identify work limits. Each input is limited to 8 million characters and 200,000 editor lines, and comparison work stops after 12 seconds. Indivisible sections that exceed the preview work budget are rejected before DOM construction, with guidance to use the native source comparison or split the section. Nothing is silently truncated. The preview size check covers rendered rows and pages. Each pair's HTML is limited to 262,144 characters and 8,000 opening elements, counting both sides. Oversized paragraphs or dense markup can reject the preview even when another part of the file changed. Use the native comparison or split ordinary text into smaller sections. Long code lines remain available when their rendered pages fit the limits. Source rows are not sent to the preview or checked against its DOM budget. Recovery uses the last confirmed snapshot, with matching content and timestamp. An overlapping command re-run can return an earlier coherent confirmed snapshot. If the browser cannot restore a view, the preview stops and points you back to the original comparison. Failed page navigation recovers at a safe starting position rather than automatically re-entering the faulty page. The preview follows the editor's theme and fonts, including high contrast. Controls work with Tab, Enter, and Space. Text can be selected and copied. Editing, saving, undo, and staging remain in VS Code. Build from sourceBuild from the repository root with Node.js 24 or newer.
Browser VS Code and provider-specific remote behavior require separate verification. The repository's verification report records the exact tested versions and environments. Develop and test
To test the installed package in an isolated profile, run this from the repository root.
The IDE runner uses the installed macOS VS Code by default. Set Release maintenanceThe Bump this extension's version in |