Leaf Markdown Viewer (Snap)

This is the unofficial snap package for leaf, a terminal-based Markdown previewer with a GUI-like experience.

Features

• Syntax highlighting for code blocks
• LaTeX math rendering
• Mermaid diagram rendering
• Interactive file picker and navigation
• Theme support (arctic, forest, ocean, solarized-dark, and custom)
• Watch mode for live preview on file changes

Install

Install the latest stable release from the Snap Store:

sudo snap install leaf

Usage

# Open the fuzzy Markdown picker
leaf

# Preview a specific Markdown file
leaf README.md

# Watch mode — reloads automatically on save
leaf --watch README.md

# Render Markdown to stdout (inline mode)
leaf --inline README.md

# Stream Markdown from another CLI tool
cat README.md | leaf --inline

# Get the version
leaf --version

# Generate shell completions
leaf --auto-complete

Limitations

This snap runs in strict confinement. To access files outside your home directory, you'll need to manually connect plugs:

snap connections leaf
snap connect leaf:removable-media

Contributing

Contributions are welcome! This snap and the upstream leaf project are both in development.

• For issues specific to the snap, file an issue in this repository.
• For leaf issues that can be reproduced when not installed as a snap, use the leaf issue tracker.
• For general snap issues, see the Snap documentation.