Skip to content
szdytomPublic

About

A fast, native Markdown reader with publication-quality typography.

Topics

Resources

Contributing

Security policy

Stars

89 stars

Watchers

1 watching

Forks

Latest commit

 

History

404 Commits

Folders and files

Repository files navigation

Markview

Markview

Open quickly. Settle into reading.
A lightweight, native Markdown reader for desktop and Android.
Clear text, mathematics and code, with publication-quality typography.

Download Markview · Explore themes · User guide

English · 简体中文

Real Markview interfaces in a desktop monitor, Android phone and tablet composition

Install Now

Choose your platform from the latest release:

Platform Download Getting started
Windows .msi installer or portable .zip Windows 10+; the installer adds Markdown file associations
macOS Zipped .app Apple Silicon, macOS 11+; see the unsigned-app setup below
Linux .deb, AppImage or .tar.gz See the runtime requirements
Android .apk Android 9+; ARM64 phones and tablets

Or install the markview command with a script:

Linux / macOS — Shell

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/szdytom/markview/releases/latest/download/markview-installer.sh | sh

Windows — PowerShell

irm https://github.com/szdytom/markview/releases/latest/download/markview-installer.ps1 | iex

Arch Linux — AUR

yay -S markview-bin

The AUR also offers a source build.

Desktop: open a Markdown file, or choose Markview from Open with. Android: open or share a document to Read in Markview. Import its folder when you want to read linked chapters and local images together.

The macOS app is unsigned. After moving it to Applications, run:

xattr -d com.apple.quarantine /Applications/Markview.app

Full installation guide · Android guide

Typography that keeps the page in balance

An even right edge, without distracting gaps between words. Markview breaks lines across the whole paragraph and hyphenates English words to balance the text. Below, the same passage uses the same font, size and column width in a browser's default left-aligned layout and Markview's justified layout.

The same English passage: browser default left alignment on the left, Markview's paragraph layout with an even right edge on the right

How this comparison is rendered · Text: A Declaration of the Independence of Cyberspace, John Perry Barlow.

Careful CJK punctuation and native LaTeX keep text and mathematics readable, with no separate TeX installation. Tables, highlighted code, footnotes, GitHub alerts, images and Mermaid diagrams belong on the same page. Markdown is rendered directly to the screen, without a browser or WebView. The native app is read-only: your source stays yours.

Read across different kinds of documents

Long-form articles, technical manuals, mathematics—and web articles brought into the native reader. These previews come from real documents.

Long-form reading · Paragraphs and rhythm Technical documents · Code, links and tables
Paragraph typography in Aaron Swartz’s Guerilla Open Access Manifesto Data Types from the Rust Book with code, links and an integer-type table
Guerilla Open Access Manifesto · Aaron Swartz, July 2008 The Rust Programming Language · Data Types
Mathematics · Theorems and formulas Web articles · Focus on the text
Stokes’ Theorem from OpenStax Calculus Volume 3, with inline and display mathematics Actual extracted prose and links from Wikipedia’s Webb’s First Deep Field article
OpenStax Calculus Volume 3 · §6.7 Stokes’ Theorem Wikipedia: Webb’s First Deep Field

Excerpts, translations and image credits. Web reading is experimental.

Make it your page

Choose a quiet light theme, a dark reading surface, or a little more character. Light and Dark share the same page layout, joined along a single diagonal below.

The same page split diagonally between Light on the left and Dark on the right

Adjust fonts and text size, or customize line spacing and more with an MVSS theme. Themes and font settings are available on desktop and Android. Explore the theme gallery · Reading settings · Theme guide

Keep your place

  • Find what matters. Search within a document or jump through its contents.
  • Read across chapters. Follow Markdown links in tabs and return to saved reading positions.
  • Take something with you. Copy text, code or formulas; export to PDF or PNG.
  • Read on your phone or tablet. Android shares the native typesetting and themes, with touch scrolling, a phone tab drawer and tablet tabs.
  • Stay up to date. Desktop file watching refreshes an open document after changes; on Android, reopen a file or folder to import changes.

Experimental web reading can also open static articles in native reader tabs. See the reading guide for controls and supported content.

Publication-quality PDF export

Take the typography with you. Native PDF export preserves carefully set paragraphs, mathematics and highlighted code, with thoughtful page breaks. Choose paper size, margins and a print theme; add headers, footers and page numbers. Text stays selectable, and links remain clickable.

Press Ctrl+E on desktop, or run markview pdf document.md -o document.pdf. PDF and image export guide

Security taken seriously

Opening a document should be a routine act. Markview treats document content as untrusted and publishes the boundaries behind its protections.

  • An explicit threat model. Documents cannot execute scripts. Resource budgets limit expensive processing, and potentially executable local link targets require confirmation. The threat model explains filesystem, network and OS-handler policies, along with their limits.
  • Fuzzing beyond crashes. Fifteen libFuzzer targets exercise parsing, incremental updates, layout, mathematics, fonts and PDF export, with structured mutations, differential checks and per-input time and allocation budgets. The fuzzing framework documents coverage and reproducible campaigns; verification status records remaining gaps.
  • Fixes that reach upstream. Markview's fuzzing has helped find and fix multiple defects in Comrak, its Markdown parser. Merged fixes include multiline inline source positions, front-matter carriage returns and paragraph ranges before CRLF tables.

To report a vulnerability privately, use GitHub Security Advisories.

Lightweight, with measurements to match

Measure Recorded result
First readable GPU frame About 100 ms, from a 10 KiB note to a 1 MiB document
Resident memory About 50 MiB for an ordinary note
Release downloads Under 20 MB, including the Android APK, in v0.2.0

Four measured documents: Markview opens in 0.101–0.115 seconds and uses 50.7–53.8 MiB RSS; MarkText 0.19.1 opens in 0.957–2.863 seconds and uses 693.2–1147.6 MiB

The comparison shows cold starts and total reader-process RSS for four fixtures, using medians of three runs on the same Linux laptop on September 22–23, 2026. MarkText is an editor with a preview; this comparison measures document reading.

Latency and memory are recorded Linux desktop measurements from an Intel Core Ultra 5 125H laptop with integrated Intel Arc, Vulkan and the performance power profile. First-frame timing includes process startup and initialization, but excludes compositor presentation. Results vary with hardware, fonts and power settings; these figures are not Android benchmarks.

Measurement method and baselines · Reader and PDF comparisons · v0.2.0 downloads

Documentation and contributing

User guides · Android · Build and contribute · Developer guides

For embedding in a web application, the separate Web/TypeScript components provide a WASM viewer and CodeMirror split editor.

Markview is open source under the MIT license. Third-party notices · All documentation

About

A fast, native Markdown reader with publication-quality typography.

Topics

Resources

Contributing

Security policy

Stars

89 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages