Repository navigation
mdview v0.3.0 adds sandboxed rendering, native parser memory limits, and standalone downloads for Linux and macOS.
Changes
- Require a rendering sandbox on Linux and macOS; refuse rendering if protection cannot start.
- Apply a 256 MiB parser memory budget through OS controls. Failed reloads keep the last valid document visible.
- Provide x64 and ARM64 archives for Linux and macOS, with licenses and shell completions.
- Add an installer that verifies the download checksum and executable version before replacement.
Install
Install from the Homebrew tap:
brew install cbuchler/tap/mdviewUse brew upgrade cbuchler/tap/mdview for future updates. Bottles are available for Linux and macOS, on x64 and ARM64.
Or use the standalone installer:
Download install-release.sh below and inspect it, then run:
sh install-release.sh --version v0.3.0The default destination is ~/.local/bin; add it to PATH. Use --install-dir to choose another directory. Each archive also supports manual extraction. Download SHA256SUMS from this release and verify the matching archive before installation.
Requirements and limits
- Native validation hosts: Ubuntu 26.04 and macOS 26, on x64 and ARM64. Other OS versions are not validated.
- Linux requires Bubblewrap and a systemd user manager with cgroup v2 memory and task controls. Host security policy must permit the required namespaces.
- macOS uses private memory APIs and the deprecated Seatbelt interface. These initial archives are not notarized. OS changes can make protection setup fail.
- The memory budget applies to the parser, not the whole viewer.
--no-sandboxexplicitly disables sandbox and OS memory protection for one invocation. mdview never falls back to unrestricted rendering automatically.- Node, npm, Bun, and a compiler are not required to run the standalone archives.
Validation
Public Homebrew installation checks passed on all four native targets: bottle installation, protected rendering without Node or Bun on PATH, completion files, and uninstall. Cross-version upgrade validation must accompany the next release because v0.3.0 is the first published formula.
All four native archive jobs passed in the distribution workflow, including rendering without Node or Bun on PATH. Linux jobs also checked terminal input, resize, and exit. macOS terminal interaction is not established by those plain-output checks.
The Linux ARM64 terminal reload-recovery check failed on the first attempt and passed on retry without a source change; its cause remains unconfirmed. All four downloaded archives passed SHA-256 verification.
Source commit: 3e4487e217decb89ca2dd62280973f990cb4c785.