mdview-cli 0.1.0

Iterate on Markdown and verify every revision with mdview.io

mdv

mdv opens Markdown in mdview.io and can keep an evolving file attached to one stable document while checking every revision in the PDF renderer.

Quick start — no token required

uv tool install mdview-cli
mdv architecture.md

mdv FILE.md is shorthand for mdv preview FILE.md: it publishes the file anonymously and opens a temporary mdview page you can share (30-day expiry, 2 MB limit). No account, token, or configuration required.

open renders a local file in the browser without uploading anything at all:

mdv open architecture.md

Verify every revision

Saved-document commands require a mdview.io CLI token because they update your documents between runs. Configure it once, then sync the same file after every edit:

mdv keys set
mdv sync architecture.md

Edit the file and run mdv sync architecture.md again. The share URL stays the same. Exit status 0 means every Mermaid diagram rendered; status 1 means the document needs attention.

mdv fix architecture.md
mdv export architecture.md

open and preview are token-free. sync, verify, fix, export, and list use a token to access Saved documents. In CI, set MDVIEW_TOKEN instead of storing it. MDVIEW_BASE_URL overrides the service URL for development.