Reading tool

Varaq

Markdown Reader

Read, edit and share Persian and English Markdown in a portable HTML file.

Where it started

Markdown is convenient to write, but a long raw document puts formatting symbols between you and the text. Add Persian, English and code to the same page and reading direction becomes part of the problem. Varaq began with that practical friction: give the document a comfortable place to be read.

How I approached it

The solution is a self-contained HTML reader with a table of contents, focus mode, theme and text-size controls. An editor makes small corrections possible in the same place. Marked parses Markdown, then an allowlist rebuilds the output before display. Paragraph direction is handled individually, while code remains left to right.

What you can try

Open an MD file, adjust its reading view, edit it, then keep the original Markdown or export a readable HTML copy. PDF uses the browser print dialog. Core reading works offline; remote images still need a connection. The package also includes a checklist variant with browser-local draft recovery.

Use it your way

Free for personal, non-commercial use. The source is included in the download. Commercial use requires prior written permission or a purchased license.

Support the project

If it helped you, you can get in touch on Telegram to arrange support.

Support via Telegram