متن 1.3.0 — Matn 1.3.0

أول إصدار على npm. التثبيت صار أمرًا واحدًا وثانية واحدة.

npm install -g @ajarallah/matn
matn README.md

أبرز ما في هذا الإصدار

القراءة

• وضع الكتاب — يقرأ SUMMARY.md كترتيب فصول مع السابق والتالي والتقدم الإجمالي، دون بناء أو تعديل الملفات.
• عرض المصدر والتقسيم — تبديل بين المصيَّر والمصدر، مع أرقام أسطر وربط كل عنوان بسطره في Markdown.
• سلامة المستند — تقرير محلي للروابط والصور والعناوين المفقودة، دون أي طلب شبكة.
• ملفات كبيرة بلا تجميد — ما تجاوز 2MB يُصيَّر في Web Worker ويُحمَّل تدريجيًا.
• ذاكرة قراءة — تستعيد الملف والقسم والموضع، مع مفضلة و«أكمل لاحقًا» وتعليقات لا تمسّ Markdown.
• بحث عربي شامل عبر المجلد، يتجاهل التشكيل والهمزات والتطويل.
• command | matn - لقراءة Markdown من stdin في جلسة مؤقتة.

إصلاحات واجهة

• الجوال يعمل — كان عمود القراءة يهبط إلى 55 بكسل فتتقطّع الكلمات حرفًا حرفًا.
• أسماء الملفات لا تنقلب — 010-market-research.md كان يُعرض market-research.md-010.
• تعليقات HTML لم تعد تظهر للقارئ — <!-- prettier-ignore --> كانت تُطبع نصًا.
• لوحة الإعدادات تفتح تحت زرّها بدل الطرف المقابل من الشاشة.
• يمكن حذف التمييز والملاحظة، ويُختار اللون مباشرة، ولكل عملية تراجع.

التوزيع

• التثبيت من دقيقتين إلى ثانية واحدة.
• النقر المزدوج على macOS لم يعد يحتاج Homebrew — يستعمل LaunchServices مباشرة.
• install-macos.sh --uninstall يعيد .md إلى تطبيقك السابق.

السجل الكامل في CHANGELOG.md.

---

First npm release. Matn is a right-to-left Markdown reader for Arabic: reading
themes, embedded Arabic fonts, math, diagrams, workspace search, annotations and
export — all local, offline, with no runtime dependencies.

Matn v1.2.7

• Arabic is now the primary README (README.md); English moves to README.en.md. The Arabic copy is rewritten in natural, plain Arabic.
• Matn ignores GitHub layout-wrapper divs (<div dir="rtl">, <div align=…>) instead of showing them as escaped text, so RTL READMEs render cleanly.

Matn v1.2.6

RTL rendering + reading-layout pass.

• Consistent RTL: headings/paragraphs follow the document's dominant direction (a Latin-first heading no longer flips an Arabic doc to LTR).
• One reading column for everything — code, tables and diagrams sit at the same edges as the text; wide content scrolls inside its own box instead of leaking past the column.
• Reading width capped to a comfortable ~1008px column (presets 80/96/112); text alignment control (Start / Justify); font picker is now a compact dropdown.
• macOS: double-clicking a .md no longer hangs Matn.app.

Matn v1.2.1

Fixes math rendering from v1.2.0 so it works everywhere (local server and the live demo).

• ∑ LaTeX is now extracted before Markdown runs, so backslashes survive; $$…$$ renders as centered display math
• Fixed a static-build bug that collapsed $$ to $
• Frontmatter tolerates a leading blank line

▶ Live demo — now shows a frontmatter card, KaTeX math, footnotes, Mermaid and a file tree.

Matn v1.2.0

Closes the main reader-parity gaps vs other markdown viewers. ▶ Live demo

• 🗂️ Frontmatter card — YAML ---…--- becomes a collapsible metadata card (not raw text)
• ∑ Math (KaTeX) — inline $…$ and block $$…$$, lazy-loaded & offline
• ⁂ Footnotes — GitHub-style [^ref] with a linked footnotes section
• 🌲 File tree — nested, collapsible directory tree in folder mode

Zero runtime deps; everything vendored & offline. npm install -g Ajarallah/matn · العربية

Matn v1.1.1

Bug-fix release, diagnosed against a real 682 KB bilingual (AR/EN) 2105-row table catalog.

• 🧾 Wide tables no longer clip — they scroll horizontally and expand to fill the pane, so multi-column bilingual tables read cleanly (no cut-off columns, no one-word-per-line towers)
• 📐 Headings match body width (font-size-independent reading measure)
• 🧭 Document direction ignores tables/code, so Latin IDs can't flip an Arabic doc to LTR

▶ Live demo · npm install -g Ajarallah/matn

Matn v1.1.0

▶ Live demo

• 🧭 Dominant-language direction — Arabic-majority files stay RTL even when they start with Latin text
• 🌐 Bilingual UI — Arabic/English interface toggle
• 🔍 Hover zoom lens on Mermaid diagrams and images
• 💾 Export menu — PDF · standalone HTML · Word (docx) · EPUB 3 (RTL page progression) · Markdown
• 🧰 Consistent labeled toolbar (Open · Save · Print · Settings)
• 🔠 Thmanyah font (Display headings + Text body) via a local folder — its license forbids redistribution, so download it from font.thmanyah.com; see vendor/fonts-local/README.md

npm install -g Ajarallah/matn · العربية

Matn v1.0.0

First stable release of متن · Matn — a calm, right-to-left Markdown reader for Arabic. ▶ Live demo

New in 1.0

• 📊 Mermaid diagrams — inline, theme-aware, sandboxed
• 💬 GFM callouts — > [!NOTE|TIP|WARNING|…]
• 🔗 Wikilinks — [[page]] / [[page|alias]]
• 🔎 In-document search — press /
• 📂 Open files from any folder — each folder gets its own contained instance
• Favicon, Linux installer, reproducible Pages build

Still the core

True per-block RTL, 4 reading themes, 5 embedded Arabic fonts (offline), syntax highlighting, TOC, live reload, print/PDF. Zero runtime dependencies.

Security

Path-traversal containment on every request, images limited to the opened root, raw HTML escaped, unsafe link schemes blocked. See SECURITY.md.

Install

npm install -g Ajarallah/matn && matn README.md
# or, no install:
npx github:Ajarallah/matn README.md

العربية

Matn v0.1.1 — design refinement

A design-system refinement pass over v0.1.0, grounded in real design references (Carbon tokens, shadcn palette, restraint & typography principles).

• Consistent tinted palettes per theme (warm paper · sepia · warm charcoal · true black)
• Lighter, intentional type weights + a fixed modular scale; tabular figures; ch-based reading measure
• Quieter chrome; refined settings popover with live font previews
• Subtle grain, tinted shadows, focus rings, press states, prefers-reduced-motion
• Progress bar via transform (GPU); removed em-dash-heavy copy
• Passes impeccable detect with zero anti-patterns

Install: npm install -g Ajarallah/matn · run: npx github:Ajarallah/matn <file>

Matn v0.1.0

First public release of متن · Matn — an RTL-first Markdown reader for Arabic.

Highlights

• True RTL (per-block dir=auto): Arabic right-aligned, code/English LTR
• 4 reading themes (Light · Sepia · Dark · Night) — follows system by default
• 5 embedded Arabic fonts (OFL, offline): System · Noto Naskh · Amiri · IBM Plex Sans Arabic · Tajawal
• Theme-aware syntax highlighting, auto TOC with scroll-spy, heading anchors
• Live reload, drag & drop, print/PDF, reading time, GFM task lists
• Zero runtime dependencies

Install

npm install -g Ajarallah/matn
matn README.md

or run without installing: npx github:Ajarallah/matn README.md

See the README · بالعربية