mdfried

You can cook a terminal. But can you deep fry a terminal? YES! You can cook and fry your tty! Run before it's too late!

The terminal is usually in "cooked" mode, or canonical mode. With ratatui🐁, it's in raw mode, but it "cooks" for you.

mdfried is a markdown viewer for the terminal that renders headers as bigger text than normal.

Screenshots

Video

How?

By rendering the headers as images, and using one of several terminal graphics protocols: Sixels, Kitty, or iTerm2.

See ratatui-image to see if your terminal does even have graphics support, and for further details.

In general, Kitty, WezTerm, iTerm2, foot, xterm -ti vt340, should work.

Usage

mdfried ./path/to.md

The first time you run mdfried, you will have to pick a font, ideally the font your terminal is using. As you type in the prompt, the first match is previewed directly. Once confirmed, this is written into the configuration file at ~/.config/mdfried/config.toml. Use --setup to force the font-setup again if the font is not right, or you switch terminals.

Press q to quit. j/k to scroll by lines, Ctrl-d/Ctrl-u to scroll by pages. r reloads the file (if not using stdin pipe). Mouse scroll also works.

Installation

• Rust cargo: cargo install mdfried
• Nix flake: github:benjajaja/mdfried
• Arch Linux: paru -S mdfried (AUR)
• Windows: Download .exe