# RivoLink/leaf

Terminal Markdown previewer — GUI-like experience.

Repository: https://github.com/RivoLink/leaf
Canonical: https://ross.abutalabs.com/products/rivolink-leaf
Homepage: https://leaf.rivolink.mg
Language: Rust
License: MIT
License Family: permissive
Topics: markdown, markdown-viewer, preview, terminal, tui, termux
Last push: 2026-08-23T15:11:20+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 10
- inputs: {"age_days": 149, "days_push": 10, "days_rel": 17, "gap_med": 0.5, "n_releases_24m": 63}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1854, forks 82 (observed 2026-08-28T04:05:44.668453+00:00)

## What it is
leaf is a terminal-based Markdown previewer written in Rust that renders files with rich formatting, syntax highlighting, LaTeX math, and Mermaid diagrams directly in the terminal. It offers interactive navigation, watch mode, fuzzy file pickers, and editor integration for a GUI-like experience without leaving the command line.

## Use cases
- preview markdown files in the terminal
- watch a markdown file and auto-reload on save
- render mermaid diagrams and latex math without a browser
- fuzzy-find and open markdown files from the command line
- pipe command output into a markdown viewer
- read documentation without leaving vim or the terminal

## When to choose
- you want rich, interactive Markdown previewing entirely inside your terminal
- you work over SSH, on Termux, or in environments without a GUI browser
- you need watch mode, TOC navigation, and editor round-tripping while writing Markdown
- you want a fast, single-binary Rust tool with broad package-manager availability

## When to avoid
- you need pixel-accurate GitHub-style rendering or image display
- you prefer GUI Markdown editors with WYSIWYG editing
- you need to export or convert Markdown to other formats

## Facets
- artifact type: cli-tool
- maturity: active
- function: markdown, terminal-ui, developer-tools, documentation
- domain: developer-tools, documentation
- platform: cli, cross-platform, windows
- tags: markdown-viewer, tui, termux, watch-mode, fuzzy-finder, syntax-highlighting, mermaid, latex, command-line, macos, linux, android

## Member repositories
- RivoLink/leaf (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:44.668453+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:16:45.844777+00:00, confidence not recorded.
  - readme: https://github.com/RivoLink/leaf (fetched 2026-08-28T04:05:44.668453+00:00, sha ee55fb7a9672)
  - homepage: https://leaf.rivolink.mg (fetched 2026-08-29T10:55:45.835636+00:00, sha 2d7314051095)
  - site_page: https://leaf.rivolink.mg/docs (fetched 2026-08-29T10:55:45.844878+00:00, sha 89e49d560d28)
- Data as of 2026-08-30T08:39:29.467469+00:00.