Revdown v0.1.0

Review Markdown without rewriting it.

Revdown v0.1.0 is the first public release of a local-first desktop application for precise, contextual Markdown review.

Open a document, select text in the rendered view, attach feedback, and export a compact review that a person, LLM, or coding agent can act on—all while the original Markdown remains byte-for-byte unchanged.

Why Revdown?

Most Markdown applications are editors. Revdown is deliberately a reviewer.

Adding comments directly to Markdown can damage formatting, mix feedback with content, and make precise selections difficult to communicate. Repository-based review tools solve a different problem and often require commits, branches, and pull requests.

Revdown fills the space between them: a focused workspace for reviewing local Markdown documents without editing the source.

Highlights

• Comment on rendered Markdown
  Select visible text and attach precise feedback without working around Markdown syntax.

• Keep the source untouched
  Comments are stored in a structured, versioned sidecar such as document.md.rd.json. The original document is never used as a write target.

• Continue reviews later
  Reopen, edit, resolve, delete, filter, and navigate comments alongside the document.

• Handle document changes conservatively
  When the source changes, Revdown re-evaluates each comment and reports it as exact, relocated, ambiguous, or unmatched. It never silently guesses where uncertain feedback belongs.

• Export actionable reviews
  Copy the review to the clipboard or save it as Markdown, with customizable instructions for a human reviewer, LLM, or coding agent.

• Render rich Markdown
  CommonMark and GitHub Flavored Markdown are supported, together with KaTeX mathematics and Shiki syntax highlighting.

• Navigate long documents
  A collapsible document outline and comment-aware minimap make it practical to review manuscripts, documentation, specifications, and other substantial files.

• Read comfortably
  Choose light, sepia, or dark themes, serif or sans-serif text, and adjustable text size, spacing, and line width.

• Work locally
  No account, network connection, API key, or hosted service is required. Your documents and comments remain on your computer.

• Open Markdown naturally
  Packaged builds register as an alternate viewer for .md and .markdown files through Finder and Explorer.

Basic workflow

1. Open a local Markdown document.
2. Select rendered text and add comments.
3. Continue the review later using the automatically associated sidecar.
4. Export the open comments when the document is ready to be revised.

Deliberately focused

Revdown v0.1.0 is a review tool, not a Markdown editor. It does not automatically rewrite documents, call an LLM API, synchronize through the cloud, or provide real-time collaboration.

For precise anchoring, a selection must remain within one supported source-backed block, such as a paragraph, heading, list item, table cell, blockquote, or code block. MDX and arbitrary Markdown dialects are not currently supported.

Downloads

Choose the appropriate installer from the Assets section below:

• macOS: Universal DMG for Apple Silicon and Intel Macs
• Windows: 64-bit installer

Feedback

This is an early release, and real-world documents are the best test of Revdown’s approach. Bug reports, usability feedback, and examples that challenge Markdown rendering or comment re-anchoring are especially valuable.

Please open an issue when you find something that could be improved.

Revdown is free and open-source software released under the MIT License.