mdless

A utility that provides a formatted and highlighted view of Markdown files in Terminal.

Runs as mdless|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 8 fields

Render a Markdown file in the terminal with mdless. Debug, config-update and some formatting toggles are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui mdless

View MarkdownExample values, fixed in this page — nothing here reaches a terminal

Basic

Markdown file*

file

Advanced

Column width

integer

Theme name

string

TasksEach one presets the form for one job

View a file

filewidththeme

List headers

filelist

ParametersOnly these flags are editable in the form

Markdown file

path · positional 0

List headers and exit

boolean

--list-l

Section numbers

Comma-separated numbers from --list.
string

--section-s

Disable pager

boolean

-P

Column width

integer

--width-w

Theme name

string

--theme-t

Link style

enum

--linksinlinereferenceparagraph

Images

enum

--images-ilocalremotenone

SourcesEvery flag above is checked against these

help

-c, --[no-]color Colorize output (default on) -i, --images=TYPE Include [local|remote (both)|none] images in output (requires chafa or imgcat, default none). -l, --list List headers in document and exit -p, --[no-]pager Formatted output to pager (default on) -P…

help2026-10-27

github.com

Before it fills your prompt, Otty checks the installed mdless against its version. A form that does not match your version is not offered.