BlogUpdated 2026-09-24

BidiMD RTL preview notes

Why Mohammad Pouya Ghourchiani built BidiMD — bilingual Markdown preview that does not fight Persian/Arabic direction.

By Pouya GhourchianiGhourchiani

engineeringtypescript

BidiMD exists because most Markdown previews assume LTR chrome and treat RTL as an afterthought. Editors then “fix” Persian by pasting into another app.

The bar

Preview must respect direction without destroying Latin code spans. Marketplace install must work for people who cannot reach every CDN. Docs must not pretend English-only is enough.

Shipping surface

VS Marketplace / Open VSX under the long-lived publisher identity — same person as this site. See publish notes and the Open VSX checklist.