A dedicated Markdown reader

A little less syntax.
A little more clarity.

Read the README. Follow the guide. Get lost in the words.
Marklight gives your Markdown a quiet place to live, in your terminal or on your desktop.

Get started Read the documentation

.md

Your files.
Your machine.
Your reading space.

Written in Rust.
Open source. MIT licensed.

01 / On your desktop

Make room for the document.

Marklight reader in light theme, showing a document outline, task list, highlighted Rust code and reading progress. — Reader interface · GFM example · light themeGet the sample Markdown

Find your place.

A heading outline and in-document search help you move through longer reads. Reading progress keeps your bearings.

ii.

Stay in the flow.

Choose light, dark or system theme. Adjust the type size, hide the outline, or enter zen mode for just the page.

iii.

Keep the details.

Tables, task lists and highlighted code belong in the document. Copy code from its original source, including line endings.

02 / In your terminal

The same words.
A different window.

Read a file where you already work. Open a directory’s README, pipe Markdown from another command, or set the width for your terminal.

Long reads use your pager. With less, press / to search, n for the next match and q to leave.

Explore the CLI

One shared Rust document engine.
Two ways to read.

marklight gfm.md --width 60

Marklight
━━━━━━━━━

A fast and quiet reader. Noise and inline code.

Read

│ Markdown should be pleasant to read.

1. Open a file
2. Read it
  • Nested item

☑ Native
☐ Next release

╭─ rust
│ fn main() {
│     println!("Marklight");
│ }
╰─

View the complete example output

03 / A smaller reading ritual

A file is all
you need.

Local, from the first page.

Open the files already on your machine. Preferences and recent paths stay in a local configuration file. No account, server or telemetry.

Your document can keep moving.

Save changes in your editor and the desktop reader reloads the file, preserving your reading context. Follow relative Markdown links to the next document.

Images with a clear boundary.

Local raster images load from the document’s own directory tree. Remote images stay unloaded, so opening a document doesn’t contact an image tracker.

04 / Start reading

One command
closer to the page.

Install the terminal reader on macOS Apple Silicon,
or build from the Rust source repository.

Installation details

Terminal

macOS Apple Silicon

npm install --global marklight

Other platforms: build the CLI with Rust stable.

cargo install --git https://github.com/OthmaneBlial/marklight marklight

marklight README.md
marklight .
git show HEAD:README.md | marklight -

Desktop

Rust + Node.js + Tauri prerequisites

git clone https://github.com/OthmaneBlial/marklight.git
cd marklight/apps/desktop
npm ci
npm run tauri -- build --features custom-protocol --bundles app

This command builds a macOS app. Requires Tauri build dependencies. Read the build notes.

Markdown should be
pleasant to read.

Explore the source

A little less syntax.A little more clarity.