From 8f6a57e71d9e2d051bfb32bba0e479e4704d0930 Mon Sep 17 00:00:00 2001 From: "Md. Fahim Bin Amin" Date: Sat, 4 Jul 2026 07:36:33 +0600 Subject: [PATCH 1/3] Add Bengali README and links (#4823) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add Bengali README and links Add a Bengali (bn) translation at docs/i18n/README-bn.md and update the main README and i18n README files to include a Bangladesh (🇧🇩) link/icon. * fix(i18n): replace Bangladesh flag emoji with text representation in README files --- README.md | 3 + docs/i18n/README-ar.md | 3 + docs/i18n/README-bn.md | 201 ++++++++++++++++++++++++++++++++++++++ docs/i18n/README-de.md | 3 + docs/i18n/README-es.md | 3 + docs/i18n/README-fr.md | 3 + docs/i18n/README-jp.md | 3 + docs/i18n/README-kr.md | 3 + docs/i18n/README-pt.md | 3 + docs/i18n/README-tr.md | 3 + docs/i18n/README-zh_cn.md | 3 + docs/i18n/README-zh_tw.md | 3 + 12 files changed, 234 insertions(+) create mode 100644 docs/i18n/README-bn.md diff --git a/README.md b/README.md index 016b00be78..b1a14e6164 100644 --- a/README.md +++ b/README.md @@ -84,6 +84,9 @@ :kr: + + :bangladesh: +
diff --git a/docs/i18n/README-ar.md b/docs/i18n/README-ar.md index ea2f0ccf84..3a7f044a1b 100644 --- a/docs/i18n/README-ar.md +++ b/docs/i18n/README-ar.md @@ -90,6 +90,9 @@ :kr: + + :bangladesh: +
diff --git a/docs/i18n/README-bn.md b/docs/i18n/README-bn.md new file mode 100644 index 0000000000..991d115142 --- /dev/null +++ b/docs/i18n/README-bn.md @@ -0,0 +1,201 @@ +

MarkText

+ +

MarkText

+ +
+ + twitter + +
+
+ :high_brightness: āĻ†āĻ§ā§āĻ¨āĻŋāĻ• āĻĒā§āĻ°āĻœāĻ¨ā§āĻŽā§‡āĻ° Markdown āĻāĻĄāĻŋāĻŸāĻ° :crescent_moon:
+ āĻāĻ•āĻŸāĻŋ āĻ¸āĻžāĻ§āĻžāĻ°āĻŖ āĻāĻŦāĻ‚ āĻ…āĻ¤ā§āĻ¯āĻžāĻ§ā§āĻ¨āĻŋāĻ• āĻ“āĻĒā§‡āĻ¨-āĻ¸ā§‹āĻ°ā§āĻ¸ Markdown āĻāĻĄāĻŋāĻŸāĻ° āĻ¯āĻž āĻ—āĻ¤āĻŋ āĻāĻŦāĻ‚ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ°āĻ¯ā§‹āĻ—ā§āĻ¯āĻ¤āĻžāĻ° āĻĻāĻŋāĻ•ā§‡ āĻ—ā§āĻ°ā§āĻ¤ā§āĻ¤ āĻĻā§‡ā§ŸāĨ¤
+ Linux, macOS āĻāĻŦāĻ‚ Windows-āĻāĻ° āĻœāĻ¨ā§āĻ¯āĨ¤ +
+ +
+ +
+ + + LICENSE + + + + total download + + + + latest download + + + + sponsors + +
+ +
+

+ + Website + + | + + āĻŦā§ˆāĻļāĻŋāĻˇā§āĻŸā§āĻ¯ + + | + + āĻĄāĻžāĻ‰āĻ¨āĻ˛ā§‹āĻĄ + + | + + āĻĄā§‡āĻ­ā§‡āĻ˛āĻĒāĻŽā§‡āĻ¨ā§āĻŸ + + | + + āĻ…āĻŦāĻĻāĻžāĻ¨ + +

+
+ +
+ āĻ…āĻ¨ā§āĻŦāĻžāĻĻāĻ¸āĻŽā§‚āĻš: + + :uk: + + + :cn: + + + :taiwan: + + + :de: + + + :jp: + + + :fr: + + + :tr: + + + :es: + + + :portugal: + + + :kr: + + + :saudi_arabia: + +
+ +
+ āĻāĻ‡ Markdown āĻāĻĄāĻŋāĻŸāĻ°āĻŸāĻŋ ❤ī¸Ž āĻĻāĻŋā§Ÿā§‡ āĻ¤ā§ˆāĻ°āĻŋ āĻ•āĻ°ā§‡āĻ›ā§‡āĻ¨ + Jocs āĻāĻŦāĻ‚ + + āĻ…āĻŦāĻĻāĻžāĻ¨āĻ•āĻžāĻ°ā§€āĻ°āĻž + + āĨ¤ + +
+ +
+ +

āĻ¸ā§āĻĒāĻ¨āĻ¸āĻ°

+ +MarkText āĻāĻ•āĻŸāĻŋ āĻ“āĻĒā§‡āĻ¨-āĻ¸ā§‹āĻ°ā§āĻ¸ Markdown āĻāĻĄāĻŋāĻŸāĻ°, āĻ¯āĻž āĻāĻ° āĻ•āĻŽāĻŋāĻ‰āĻ¨āĻŋāĻŸāĻŋāĻ° āĻ¸āĻšāĻžā§ŸāĻ¤āĻžā§Ÿ āĻāĻ—āĻŋā§Ÿā§‡ āĻšāĻ˛āĻ›ā§‡āĨ¤ MarkText āĻ¯āĻĻāĻŋ āĻ†āĻĒāĻ¨āĻžāĻ° āĻ•āĻžāĻœā§‡āĻ° āĻ§āĻžāĻ°āĻž āĻ‰āĻ¨ā§āĻ¨āĻ¤ āĻ•āĻ°ā§‡ āĻĨāĻžāĻ•ā§‡, āĻ¤āĻžāĻšāĻ˛ā§‡ āĻ…āĻ¨ā§āĻ—ā§āĻ°āĻš āĻ•āĻ°ā§‡ [āĻĒā§āĻ°āĻœā§‡āĻ•ā§āĻŸāĻŸāĻŋāĻ•ā§‡ āĻ¸ā§āĻĒāĻ¨āĻ¸āĻ° āĻ•āĻ°āĻžāĻ°](https://github.com/sponsors/marktext) āĻ•āĻĨāĻž āĻŦāĻŋāĻŦā§‡āĻšāĻ¨āĻž āĻ•āĻ°ā§āĻ¨āĨ¤ āĻ¸āĻŦ āĻ¸ā§āĻĒāĻ¨āĻ¸āĻ°āĻ•ā§‡ āĻ§āĻ¨ā§āĻ¯āĻŦāĻžāĻĻ ❤ī¸ + +**āĻŦāĻŋāĻļā§‡āĻˇ āĻ¸ā§āĻĒāĻ¨āĻ¸āĻ°** + +| [](https://serpapi.com/?utm_source=marktext) | [āĻ†āĻŽāĻžāĻĻā§‡āĻ° āĻĻā§āĻ°ā§āĻ¤, āĻ¸āĻšāĻœ āĻāĻŦāĻ‚ āĻĒā§‚āĻ°ā§āĻŖāĻžāĻ™ā§āĻ— API āĻĻāĻŋā§Ÿā§‡ Google āĻ“ āĻ…āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻ¸āĻžāĻ°ā§āĻš āĻ‡āĻžā§āĻœāĻŋāĻ¨ āĻĨā§‡āĻ•ā§‡ āĻĢāĻ˛āĻžāĻĢāĻ˛ āĻ¸āĻ‚āĻ—ā§āĻ°āĻš āĻ•āĻ°ā§āĻ¨āĨ¤](https://serpapi.com/?utm_source=marktext) | +| ------------- |:-------------| + +## āĻ¸ā§āĻ•ā§āĻ°āĻŋāĻ¨āĻļāĻŸ + +![](../assets/marktext.png?raw=true) + +## āĻŦā§ˆāĻļāĻŋāĻˇā§āĻŸā§āĻ¯ + +- āĻ°āĻŋā§Ÿā§‡āĻ˛āĻŸāĻžāĻ‡āĻŽ āĻĒā§āĻ°āĻŋāĻ­āĻŋāĻ‰ (WYSIWYG) āĻāĻŦāĻ‚ āĻĒāĻ°āĻŋāĻšā§āĻ›āĻ¨ā§āĻ¨, āĻ†āĻ§ā§āĻ¨āĻŋāĻ• āĻ‡āĻ¨ā§āĻŸāĻžāĻ°āĻĢā§‡āĻ¸ āĻ†āĻĒāĻ¨āĻžāĻ•ā§‡ āĻ—āĻ­ā§€āĻ° āĻŽāĻ¨ā§‹āĻ¯ā§‹āĻ—ā§‡āĻ° āĻ¸āĻžāĻĨā§‡ āĻ˛ā§‡āĻ–āĻžāĻ° āĻ…āĻ­āĻŋāĻœā§āĻžāĻ¤āĻž āĻĻā§‡ā§ŸāĨ¤ +- [CommonMark Spec](https://spec.commonmark.org), [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) āĻāĻŦāĻ‚ āĻ†āĻ‚āĻļāĻŋāĻ•āĻ­āĻžāĻŦā§‡ [Pandoc markdown](https://pandoc.org/MANUAL.html#pandocs-markdown) āĻ¸āĻŽāĻ°ā§āĻĨāĻ¨ āĻ•āĻ°ā§‡āĨ¤ +- Markdown āĻāĻ•ā§āĻ¸āĻŸā§‡āĻ¨āĻļāĻ¨ āĻ¯ā§‡āĻŽāĻ¨ āĻ—āĻŖāĻŋāĻ¤ā§‡āĻ° āĻ…āĻ­āĻŋāĻŦā§āĻ¯āĻ•ā§āĻ¤āĻŋ (KaTeX), front matter āĻāĻŦāĻ‚ emoji āĻ¸āĻŽāĻ°ā§āĻĨāĻ¨ āĻ•āĻ°ā§‡āĨ¤ +- āĻĻā§āĻ°ā§āĻ¤ āĻ˛ā§‡āĻ–āĻžāĻ° āĻœāĻ¨ā§āĻ¯ paragraph āĻ“ inline style shortcut āĻ¸āĻŽāĻ°ā§āĻĨāĻ¨ āĻ•āĻ°ā§‡āĨ¤ +- **HTML** āĻāĻŦāĻ‚ **PDF** āĻĢāĻžāĻ‡āĻ˛ā§‡ āĻāĻ•ā§āĻ¸āĻĒā§‹āĻ°ā§āĻŸ āĻ•āĻ°āĻž āĻ¯āĻžā§ŸāĨ¤ +- āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āĻ¨ [theme](https://marktext.me/docs/themes): **Cadmium Light**, **Material Dark** āĻ‡āĻ¤ā§āĻ¯āĻžāĻĻāĻŋāĨ¤ +- āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āĻ¨ āĻāĻĄāĻŋāĻŸāĻŋāĻ‚ āĻŽā§‹āĻĄ: **Source Code mode**, **Typewriter mode**, **Focus mode**āĨ¤ +- āĻ•ā§āĻ˛āĻŋāĻĒāĻŦā§‹āĻ°ā§āĻĄ āĻĨā§‡āĻ•ā§‡ āĻ¸āĻ°āĻžāĻ¸āĻ°āĻŋ āĻ›āĻŦāĻŋ āĻĒā§‡āĻ¸ā§āĻŸ āĻ•āĻ°āĻž āĻ¯āĻžā§ŸāĨ¤ + +## āĻĄāĻžāĻ‰āĻ¨āĻ˛ā§‹āĻĄ āĻ“ āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ā§‡āĻļāĻ¨ + +![platform](https://img.shields.io/static/v1.svg?label=Platform&message=Linux%20x64%20|%20macOS%20x64%2Farm64%20|%20Windows%20x64%2Farm64&style=for-the-badge) + +| ![](https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/screenshots/v1.0.x/mac-pass-sm.png) | ![](https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/screenshots/v1.0.x/windows-pass-sm.png) | ![](https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/screenshots/v1.0.x/linux-pass-sm.png) | +|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| [![Download for macOS](https://img.shields.io/badge/macOS-Download-blue)](https://github.com/marktext/marktext/releases/latest) | [![Download for Windows](https://img.shields.io/badge/Windows-Download-blue)](https://github.com/marktext/marktext/releases/latest) | [![Download for Linux](https://img.shields.io/badge/Linux-Download-blue)](https://github.com/marktext/marktext/releases/latest) | + +āĻ¸āĻ°ā§āĻŦāĻļā§‡āĻˇ āĻ¸āĻ‚āĻ¸ā§āĻ•āĻ°āĻŖā§‡āĻ° āĻ¨āĻ¤ā§āĻ¨ āĻĢāĻŋāĻšāĻžāĻ°āĻ—ā§āĻ˛ā§‹ āĻĻā§‡āĻ–āĻ¤ā§‡ [CHANGELOG](https://marktext.me/docs/changelog) āĻĻā§‡āĻ–ā§āĻ¨āĨ¤ + +#### macOS + +macOS 11 (Big Sur) āĻŦāĻž āĻĒāĻ°āĻŦāĻ°ā§āĻ¤ā§€ āĻ¸āĻ‚āĻ¸ā§āĻ•āĻ°āĻŖ āĻĒā§āĻ°ā§Ÿā§‹āĻœāĻ¨āĨ¤ Universal build āĻĒā§āĻ°āĻ•āĻžāĻļ āĻ•āĻ°āĻž āĻšā§Ÿ āĻ¨āĻž, āĻ¤āĻžāĻ‡ āĻ†āĻĒāĻ¨āĻžāĻ° āĻŽā§‡āĻļāĻŋāĻ¨ā§‡āĻ° āĻ¸āĻ™ā§āĻ—ā§‡ āĻŽāĻŋāĻ˛ āĻĨāĻžāĻ•āĻž `arm64` āĻŦāĻž `x64` installer āĻŦā§‡āĻ›ā§‡ āĻ¨āĻŋāĻ¨āĨ¤ + +āĻ†āĻĒāĻ¨āĻŋ [release page](https://github.com/marktext/marktext/releases/latest) āĻĨā§‡āĻ•ā§‡ āĻ¸āĻ°ā§āĻŦāĻļā§‡āĻˇ `marktext-mac-(arm64|x64)-%version%.dmg` āĻĄāĻžāĻ‰āĻ¨āĻ˛ā§‹āĻĄ āĻ•āĻ°āĻ¤ā§‡ āĻĒāĻžāĻ°ā§‡āĻ¨, āĻ…āĻĨāĻŦāĻž [**homebrew cask**](https://github.com/caskroom/homebrew-cask) āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻ•āĻ°ā§‡ MarkText āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°āĻ¤ā§‡ āĻĒāĻžāĻ°ā§‡āĻ¨āĨ¤ Homebrew-Cask āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻ•āĻ°āĻ¤ā§‡ āĻšāĻ˛ā§‡ āĻ†āĻ—ā§‡ [Homebrew](https://brew.sh/) āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°āĻž āĻĨāĻžāĻ•āĻ¤ā§‡ āĻšāĻŦā§‡āĨ¤ + +```bash +brew install --cask mark-text +``` + +#### Windows + +Windows 10 āĻ…āĻĨāĻŦāĻž 11 āĻĒā§āĻ°ā§Ÿā§‹āĻœāĻ¨āĨ¤ x64 āĻāĻŦāĻ‚ arm64 - āĻ‰āĻ­ā§Ÿ installer āĻĒā§āĻ°āĻ•āĻžāĻļ āĻ•āĻ°āĻž āĻšā§Ÿ, āĻ¤āĻžāĻ‡ āĻ†āĻĒāĻ¨āĻžāĻ° āĻŽā§‡āĻļāĻŋāĻ¨ā§‡āĻ° architecture āĻ…āĻ¨ā§āĻ¯āĻžā§Ÿā§€āĻŸāĻŋ āĻŦā§‡āĻ›ā§‡ āĻ¨āĻŋāĻ¨āĨ¤ + +āĻļā§āĻ§ā§ setup wizard (`marktext-win-(x64|arm64)-%version%-setup.exe`) āĻĄāĻžāĻ‰āĻ¨āĻ˛ā§‹āĻĄ āĻ•āĻ°ā§‡ āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°ā§āĻ¨ āĻāĻŦāĻ‚ user-only āĻ¨āĻžāĻ•āĻŋ machine-wide āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°āĻŦā§‡āĻ¨ āĻ¤āĻž āĻŦā§‡āĻ›ā§‡ āĻ¨āĻŋāĻ¨āĨ¤ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒāĻ­āĻžāĻŦā§‡, [Chocolatey](https://chocolatey.org/) āĻŦāĻž [Winget](https://docs.microsoft.com/en-us/windows/package-manager/winget/) āĻāĻ° āĻŽāĻ¤ā§‹ package manager āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻ•āĻ°ā§‡āĻ“ MarkText āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°āĻ¤ā§‡ āĻĒāĻžāĻ°ā§‡āĻ¨āĨ¤ + +Chocolatey āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻ•āĻ°āĻ¤ā§‡ āĻšāĻžāĻ‡āĻ˛ā§‡ āĻ†āĻ—ā§‡ [Chocolatey](https://chocolatey.org/install) āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°āĻž āĻĨāĻžāĻ•āĻ¤ā§‡ āĻšāĻŦā§‡: + +```bash +choco install marktext +``` + +Winget āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻ•āĻ°āĻ¤ā§‡ āĻšāĻžāĻ‡āĻ˛ā§‡ āĻ†āĻ—ā§‡ [Winget](https://docs.microsoft.com/en-us/windows/package-manager/winget/#install-winget) āĻ‡āĻ¨āĻ¸ā§āĻŸāĻ˛ āĻ•āĻ°āĻž āĻĨāĻžāĻ•āĻ¤ā§‡ āĻšāĻŦā§‡: + +```bash +winget install marktext +``` + +#### Linux + +āĻ…āĻ¨ā§āĻ—ā§āĻ°āĻš āĻ•āĻ°ā§‡ [Linux installation instructions](https://marktext.me/docs/installation) āĻ…āĻ¨ā§āĻ¸āĻ°āĻŖ āĻ•āĻ°ā§āĻ¨āĨ¤ + +#### āĻ…āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ + +Linux, macOS āĻāĻŦāĻ‚ Windows-āĻāĻ° āĻ¸āĻŦ binary [release page](https://github.com/marktext/marktext/releases/latest) āĻĨā§‡āĻ•ā§‡ āĻĄāĻžāĻ‰āĻ¨āĻ˛ā§‹āĻĄ āĻ•āĻ°āĻž āĻ¯āĻžāĻŦā§‡āĨ¤ āĻ†āĻĒāĻ¨āĻžāĻ° āĻ¸āĻŋāĻ¸ā§āĻŸā§‡āĻŽā§‡āĻ° āĻœāĻ¨ā§āĻ¯ āĻ•ā§‹āĻ¨ā§‹ āĻ¸āĻ‚āĻ¸ā§āĻ•āĻ°āĻŖ āĻ¨āĻž āĻĨāĻžāĻ•āĻ˛ā§‡ āĻāĻ•āĻŸāĻŋ [issue](https://github.com/marktext/marktext/issues) āĻ–ā§āĻ˛ā§āĻ¨āĨ¤ + +## āĻĄā§‡āĻ­ā§‡āĻ˛āĻĒāĻŽā§‡āĻ¨ā§āĻŸ + +āĻ†āĻĒāĻ¨āĻŋ āĻ¯āĻĻāĻŋ āĻ¨āĻŋāĻœā§‡ MarkText build āĻ•āĻ°āĻ¤ā§‡ āĻšāĻžāĻ¨, āĻ¤āĻžāĻšāĻ˛ā§‡ āĻ†āĻŽāĻžāĻĻā§‡āĻ° [build instructions](https://marktext.me/docs/dev/build) āĻĻā§‡āĻ–ā§āĻ¨āĨ¤ + +- [āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ°āĻ•āĻžāĻ°ā§€ āĻĄāĻ•ā§āĻŽā§‡āĻ¨ā§āĻŸā§‡āĻļāĻ¨](https://marktext.me/docs/introduction) +- [āĻĄā§‡āĻ­ā§‡āĻ˛āĻĒāĻžāĻ° āĻĄāĻ•ā§āĻŽā§‡āĻ¨ā§āĻŸā§‡āĻļāĻ¨](https://marktext.me/docs/dev/overview) + +MarkText āĻ¸āĻŽā§āĻĒāĻ°ā§āĻ•ā§‡ āĻ†āĻĒāĻ¨āĻžāĻ° āĻ•ā§‹āĻ¨ā§‹ āĻĒā§āĻ°āĻļā§āĻ¨ āĻĨāĻžāĻ•āĻ˛ā§‡ issue āĻ–ā§āĻ˛āĻ¤ā§‡ āĻĒāĻžāĻ°ā§‡āĻ¨āĨ¤ Issue āĻ–ā§‹āĻ˛āĻžāĻ° āĻ¸āĻŽā§Ÿ āĻ…āĻ¨ā§āĻ—ā§āĻ°āĻš āĻ•āĻ°ā§‡ āĻĄāĻŋāĻĢāĻ˛ā§āĻŸ āĻĢāĻ°āĻŽā§āĻ¯āĻžāĻŸāĻŸāĻŋ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻ•āĻ°ā§āĻ¨āĨ¤ āĻ…āĻŦāĻļā§āĻ¯āĻ‡, āĻ¸āĻ°āĻžāĻ¸āĻ°āĻŋ PR āĻĒāĻžāĻ āĻžāĻ˛ā§‡ āĻ¸ā§‡āĻŸāĻŋāĻ“ āĻ…āĻ¤ā§āĻ¯āĻ¨ā§āĻ¤ āĻĒā§āĻ°āĻļāĻ‚āĻ¸āĻŋāĻ¤ āĻšāĻŦā§‡āĨ¤ + +## āĻ…āĻŦāĻĻāĻžāĻ¨ + +MarkText āĻāĻ–āĻ¨ā§‹ āĻ‰āĻ¨ā§āĻ¨ā§ŸāĻ¨āĻžāĻ§ā§€āĻ¨, āĻ¤āĻžāĻ‡ pull request āĻ•āĻ°āĻžāĻ° āĻ†āĻ—ā§‡ [Contributing Guide](../../.github/CONTRIBUTING.md) āĻĒā§œā§‡ āĻ¨āĻŋāĻ¨āĨ¤ MarkText-āĻ āĻ¨āĻ¤ā§āĻ¨ āĻĢāĻŋāĻšāĻžāĻ° āĻ¯ā§‹āĻ— āĻ•āĻ°āĻ¤ā§‡ āĻšāĻžāĻ¨? āĻ†āĻŽāĻžāĻĻā§‡āĻ° [roadmap](https://github.com/marktext/marktext/projects) āĻāĻŦāĻ‚ open issue āĻĻā§‡āĻ–ā§āĻ¨āĨ¤ + +## āĻ…āĻŦāĻĻāĻžāĻ¨āĻ•āĻžāĻ°ā§€āĻ°āĻž + +āĻ¯āĻžāĻ°āĻž āĻ‡āĻ¤āĻŋāĻŽāĻ§ā§āĻ¯ā§‡āĻ‡ MarkText-āĻ āĻ…āĻŦāĻĻāĻžāĻ¨ āĻ°ā§‡āĻ–ā§‡āĻ›ā§‡āĻ¨, āĻ¤āĻžāĻĻā§‡āĻ° āĻ¸āĻŦāĻžāĻ‡āĻ•ā§‡ āĻ§āĻ¨ā§āĻ¯āĻŦāĻžāĻĻ [[contributors](https://github.com/marktext/marktext/graphs/contributors)]āĨ¤ + + + +## āĻ˛āĻžāĻ‡āĻ¸ā§‡āĻ¨ā§āĻ¸ + +[**MIT**](../../LICENSE)āĨ¤ diff --git a/docs/i18n/README-de.md b/docs/i18n/README-de.md index 0ca1d68fdd..c5acaad42b 100644 --- a/docs/i18n/README-de.md +++ b/docs/i18n/README-de.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-es.md b/docs/i18n/README-es.md index 4c4f0b8afe..7780e76563 100644 --- a/docs/i18n/README-es.md +++ b/docs/i18n/README-es.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-fr.md b/docs/i18n/README-fr.md index 27be6e8e80..98180a1549 100644 --- a/docs/i18n/README-fr.md +++ b/docs/i18n/README-fr.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-jp.md b/docs/i18n/README-jp.md index 4394d0b26e..768910774c 100644 --- a/docs/i18n/README-jp.md +++ b/docs/i18n/README-jp.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-kr.md b/docs/i18n/README-kr.md index 676c72e3c3..4750cefa29 100644 --- a/docs/i18n/README-kr.md +++ b/docs/i18n/README-kr.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-pt.md b/docs/i18n/README-pt.md index 4f6af02f12..c0dc805f2e 100644 --- a/docs/i18n/README-pt.md +++ b/docs/i18n/README-pt.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-tr.md b/docs/i18n/README-tr.md index 3ed94b8782..bdefccbbf0 100644 --- a/docs/i18n/README-tr.md +++ b/docs/i18n/README-tr.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-zh_cn.md b/docs/i18n/README-zh_cn.md index b8202f1157..c2e64e3161 100644 --- a/docs/i18n/README-zh_cn.md +++ b/docs/i18n/README-zh_cn.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
diff --git a/docs/i18n/README-zh_tw.md b/docs/i18n/README-zh_tw.md index 2fdb91fb71..000fed1c99 100644 --- a/docs/i18n/README-zh_tw.md +++ b/docs/i18n/README-zh_tw.md @@ -90,6 +90,9 @@ :saudi_arabia: + + :bangladesh: +
From 54a65e7fef4e90b632c5ef294e492bd7d53561fc Mon Sep 17 00:00:00 2001 From: Taekhun Nam Date: Sat, 4 Jul 2026 11:07:51 +0900 Subject: [PATCH 2/3] fix(muya): skip identity operations during deferred flush (#4815) ot-json1.compose() may legitimately return the identity operation (null) when queued operations cancel each other out, such as during IME composition. JSONState._flushOperationCache() assumed that any non-empty operation batch would compose to a non-null operation and emitted it through the json-change event. Downstream consumers such as History expected a JSONOpList and crashed when receiving null. Skip emitting json-change for identity operations to preserve the ot-json1 contract and avoid forwarding no-op operations. --- packages/muya/src/state/index.ts | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/packages/muya/src/state/index.ts b/packages/muya/src/state/index.ts index d7515f1b4f..39bcdf7bf6 100644 --- a/packages/muya/src/state/index.ts +++ b/packages/muya/src/state/index.ts @@ -272,8 +272,9 @@ class JSONState { // (acc, current, index, array) to the callback, but // `json1.type.compose` only accepts (op1, op2). Without the // wrapper TS rejects the signature mismatch. - // `compose` returns JSONOp (= null | JSONOpList); a non-empty cache - // (guarded above) always composes to a non-null op. + // `compose` returns JSONOp (= null | JSONOpList). Multiple queued + // operations may cancel each other out (for example during IME + // composition), producing the identity operation (`null`). const op = this._operationCache.reduce( (acc, curr) => json1.type.compose(acc, curr) as JSONOpList, ); @@ -284,6 +285,10 @@ class JSONState { // Clear before emitting: a listener that edits synchronously then starts // a fresh batch instead of mutating the one being flushed. this._operationCache = []; + + if (op === null) + return; + this._muya.eventCenter.emit('json-change', { op, source: 'user', From 2b9c18e7aec67e0a104bebe16e85e4ac4a214929 Mon Sep 17 00:00:00 2001 From: Ran Luo Date: Sat, 4 Jul 2026 10:18:47 +0800 Subject: [PATCH 3/3] fix(muya): harden History against identity (null) json-change ops (#4838) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * fix(muya): tolerate identity (null) json-change ops in History `ot-json1.compose()` legitimately returns the identity operation (`null`) when queued operations cancel each other out (for example during IME composition). PR #4815 stopped the deferred-flush emitter from forwarding that null, but `dispatch()` — used by `Editor.updateContents` and `rebuildContents` — still forwards it deliberately, and the `updateContents` contract explicitly routes the no-op through `json-change`. `History`'s `json-change` listener passed the op straight to `_record` (and `_transform`), both of which read `op.length` and crash on `null` with `TypeError: Cannot read properties of null (reading 'length')`. Ignore identity ops in the listener: a no-op has nothing to record or transform. This closes the crash at the consumer regardless of which emitter produced the null. Refs #4806 Co-Authored-By: Claude Opus 4.8 (1M context) * test(muya): cover identity-op json-change crash (#4806) Two regressions for the null-op crash: - `updateContents(null)` drives the `dispatch` path that forwards the identity op through `json-change`; asserts History neither crashes nor records an undo entry. - Flushing a compose-to-null batch (an op and its exact inverse) asserts the deferred-flush emitter stays silent, locking the PR #4815 fix. Co-Authored-By: Claude Opus 4.8 (1M context) --------- Co-authored-by: Claude Opus 4.8 (1M context) --- .../__tests__/identityOpJsonChange.spec.ts | 77 +++++++++++++++++++ packages/muya/src/history/index.ts | 9 ++- 2 files changed, 85 insertions(+), 1 deletion(-) create mode 100644 packages/muya/src/history/__tests__/identityOpJsonChange.spec.ts diff --git a/packages/muya/src/history/__tests__/identityOpJsonChange.spec.ts b/packages/muya/src/history/__tests__/identityOpJsonChange.spec.ts new file mode 100644 index 0000000000..55e9f6a26e --- /dev/null +++ b/packages/muya/src/history/__tests__/identityOpJsonChange.spec.ts @@ -0,0 +1,77 @@ +// @vitest-environment happy-dom + +// Regression for #4806: an identity (`null`) ot-json1 op must never crash +// History. `compose()` legitimately yields `null` when queued ops cancel out +// (e.g. IME edits), and both the deferred-flush emitter and the `dispatch` +// path can surface it through `json-change`. `History` reads `op.length`, so a +// forwarded `null` threw `Cannot read properties of null (reading 'length')`. + +import * as json1 from 'ot-json1'; +import { afterEach, beforeEach, describe, expect, it } from 'vitest'; +import { Muya } from '../../muya'; +import { asDoc } from '../../state'; + +const bootedHosts: HTMLElement[] = []; + +beforeEach(() => { + window.MUYA_VERSION = 'test'; +}); + +afterEach(() => { + while (bootedHosts.length) + bootedHosts.pop()!.remove(); + document.getSelection()?.removeAllRanges(); + delete (window as Partial).MUYA_VERSION; +}); + +function bootMuya(markdown: string): Muya { + const host = document.createElement('div'); + document.body.appendChild(host); + const muya = new Muya(host, { markdown } as ConstructorParameters[1]); + muya.init(); + bootedHosts.push(muya.domNode); + return muya; +} + +function undoDepth(muya: Muya): number { + // @ts-expect-error — reach into the private stack for test assertions. + return muya.editor.history._stack.undo.length; +} + +describe('identity (null) op via json-change — #4806', () => { + it('updateContents(null) does not crash History and records nothing', () => { + const muya = bootMuya('hello\n'); + + // `Editor.updateContents` deliberately forwards the identity op to + // `dispatch`, which emits a `json-change` carrying `op: null`. + expect(() => muya.editor.updateContents(null, null, 'user')).not.toThrow(); + + expect(muya.getMarkdown().trim()).toBe('hello'); + expect(undoDepth(muya)).toBe(0); + }); + + it('flushing a compose-to-null batch is a no-op (locks #4815)', () => { + const muya = bootMuya('hello\n'); + const jsonState = muya.editor.jsonState; + + // A real op and its exact inverse compose to the identity op — the + // op-level shape of an IME insert cancelled by a delete in one frame. + const op = json1.insertOp([1], asDoc({ name: 'paragraph', text: 'x' } as never))!; + const inverse = json1.type.invert(op); + expect(json1.type.compose(op, inverse)).toBe(null); + + let changes = 0; + muya.eventCenter.on('json-change', () => { + changes += 1; + }); + + // @ts-expect-error — drive the private deferred-flush path directly. + jsonState._operationCache.push(op, inverse); + // @ts-expect-error — the function the crash stack named. + expect(() => jsonState._flushOperationCache()).not.toThrow(); + + expect(changes).toBe(0); + expect(muya.getMarkdown().trim()).toBe('hello'); + expect(undoDepth(muya)).toBe(0); + }); +}); diff --git a/packages/muya/src/history/index.ts b/packages/muya/src/history/index.ts index e7033fc523..cce428ce57 100644 --- a/packages/muya/src/history/index.ts +++ b/packages/muya/src/history/index.ts @@ -130,7 +130,7 @@ class History { source, prevDoc, }: { - op: JSONOpList; + op: Nullable; source: string; prevDoc: TState[]; doc: TState[]; @@ -138,6 +138,13 @@ class History { if (this._ignoreChange) return; + // The identity op (`null`) carries no change to record or + // transform. It can still reach here through `json-change` when + // queued ops compose away (e.g. IME edits, #4806); `_record` + // would otherwise crash reading `op.length`. + if (op == null) + return; + if (!this._options.userOnly || source === 'user') this._record(op, prevDoc); else