#cli #markdown

app clima

A minimal Markdown reader in the terminal

11 releases (1 stable)

1.0.0 Jul 14, 2022
0.0.10 Aug 10, 2021
0.0.7 May 2, 2020
0.0.6 Feb 25, 2020
0.0.2 Jun 29, 2019

#1812 in Command line utilities

30 downloads per month

MIT license

268 lines

Latest Version MIT Chat on Miaou


A viewer for Termimad.

This tiny application opens any Markdown file and displays it using Termimad.

Which isn't really useful as Termimad hasn't been designed to display any markdown file. Termimad is more of an helper to let you incorporate rich text and tables in your terminal applications.

Clima is thus not a general purpose Markdown viewer but can be used to try out or fix some markdown you'd like to incorporate into your terminal application using Termimad and that you prefer to edit as a file.

Installation from source

Download the Repository

git clone https://github.com/Canop/clima

and build and install clima

cd clima
cargo install --path .

Precompiled binaries

They're available at https://dystroy.org/clima


To open a file in the viewer, just pass its path:

clima README.md

You can also provide the URL of a markdown file or of a github repository:

clima https://github.com/Canop/broot

If you add the --print option, the file is just printed to stdout, the scrollable viewer doesn't appear:

clima -p README.md


~336K SLoC