diff --git a/docs/i18n/ar.md b/docs/i18n/ar.md
new file mode 100644
index 00000000..c91ce576
--- /dev/null
+++ b/docs/i18n/ar.md
@@ -0,0 +1,245 @@
+
+
+**تنويه: هذه الوثيقة قديمة وتعتمد على الملف التمهيدي الأصلي من 1 أكتوبر 2018!**
+
+

+
+
مارك تيكست
+
+
+
+ :high_brightness:محرر Markdown من الجيل التالي:crescent_moon:
+
+
+ تطبيق مبني باستخدام Electron
ومتاح لأنظمة macOS، Windows، وLinux
+
+
+
+
+
+
+
+
+
+
+
+
+
المساهمة في MarkText
+
+MarkText هو مشروع مفتوح المصدر مرخص تحت رخصة MIT، وآخر إصدار متاح دائمًا للتنزيل مجانًا من صفحة الإصدارات على GitHub. لا يزال MarkText في مرحلة التطوير، وهذا التطوير لا يمكن أن يتم دون دعم الرعاة. إذا كنت ترغب في أن تصبح راعيًا:
+
+- [كن داعمًا أو راعيًا على Patreon](https://www.patreon.com/ranluo) أو [تبرع لمرة واحدة](https://github.com/Jocs/sponsor.me)
+- [كن داعمًا أو راعيًا على Open Collective](https://opencollective.com/marktext)
+
+##### ما الفرق بين Open Collective وPatreon؟
+
+
+Patreon: تذهب جميع التبرعات مباشرة إلى Luo Ran (@jocs) الذي أنشأ MarkText ويواصل صيانته.
+Open Collective: في هذا المنصة، جميع نفقاتنا شفافة. ستُستخدم الأموال لتطوير وصيانة MarkText، وتمويل الأنشطة عبر الإنترنت وغير المتصلة، والحصول على الموارد الضرورية الأخرى.
+ستظهر أسماء وشعارات جميع الرعاة (من كل من Patreon وOpen Collective) على الموقع الرسمي لـMarkText وفي ملف README.md الخاص به.
+
+**الرعاة الخاصون**
+
+
+
+
+
+**الرعاة البلاتينيون**
+
+
+
+
+
+**الرعاة الذهبيون**
+
+
+
+
+
+**الرعاة الفضيّون**
+
+
+
+
+
+**الرعاة البرونزيّون**
+
+
+
+
+
+**الداعمون**
+
+
+
+
+
+## لقطة شاشة
+
+
+
+
+## الميزات
+
+- معاينة في الوقت الحقيقي، ويستخدم [snabbdom](https://github.com/snabbdom/snabbdom) كمحرك للتصيير.
+- يدعم [مواصفات CommonMark](https://spec.commonmark.org/0.29/) و[مواصفات GitHub Flavored Markdown](https://github.github.com/gfm/).
+- يدعم الفقرات والاختصارات داخل السطر لتحسين كفاءة الكتابة.
+- تصدير ملفات markdown إلى **HTML** و**PDF**.
+- ثيمات فاتحة وداكنة.
+- أنماط تحرير متعددة: **وضع الشيفرة المصدرية**، **وضع الآلة الكاتبة**، **وضع التركيز**.
+
+
+
:crescent_moon:ثيمات فاتحة وداكنة:high_brightness:
+
+| داكن :crescent_moon: | فاتح :high_brightness: |
+| كادميوم فاتح | داكن |
+|:--------------:|:-------:|
+|  |  |
+| جرافيت فاتح | ماتيريال داكن |
+|  |  |
+| يوليسيس فاتح | ون داكن |
+|  |  |
+
+
:smile_cat: أوضاع الكتابة :dog:
+
+| وضع تحرير المصدر | وضع الآلة الكاتبة | وضع التركيز |
+|:----------------:|:-------------------:|:--------------:|
+|  |  |  |
+
+## لماذا إنشاء محرر آخر؟
+
+1. لأننا نحب الكتابة. لقد استخدمنا العديد من محررات Markdown، ومع ذلك لا يوجد محرر يلبي احتياجاتي بالكامل. لا أحب أن أتعرض لمشاكل مزعجة أثناء الكتابة. يستخدم **MarkText** DOM افتراضيًا لرسم الصفحات، مما يوفر مزايا السرعة ومفتوح المصدر. بهذه الطريقة، يمكن لأي شخص يحب الكتابة وMarkdown استخدام MarkText.
+2. كما ذكرت أعلاه، سيكون **MarkText** دائمًا مفتوح المصدر. نأمل أن يساهم جميع محبي Markdown في الكود ويساعدوا في تطوير **MarkText** ليصبح محرر Markdown شائعًا.
+3. هناك العديد من محررات Markdown، ولكل منها مزاياها الخاصة. من الصعب إرضاء جميع مستخدمي Markdown، لكننا نأمل أن يتمكن **MarkText** من تلبية احتياجات مستخدمي Markdown قدر الإمكان. لا يزال **MarkText** غير مثالي، لكننا نحاول تحسينه قدر الإمكان.
+
+## التنزيل والتثبيت
+
+
+
+|  |  |  |
+|:--------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------:|
+| [](https://github.com/marktext/marktext/releases/download/v0.17.1/marktext-x64.dmg) | [](https://github.com/marktext/marktext/releases/download/v0.17.1/marktext-setup.exe) | [](https://github.com/marktext/marktext/releases/download/v0.17.1/marktext-x86_64.AppImage) |
+
+لمعرفة التغييرات في الإصدار الأخير، راجع [سجل التغييرات](.github/CHANGELOG.md).
+
+#### ماك
+
+يمكنك تنزيل أحدث إصدار من [صفحة الإصدارات](https://github.com/marktext/marktext/releases/latest) كملف `marktext-%version%.dmg`، أو تثبيت MarkText باستخدام Homebrew Cask. لاستخدام Homebrew-Cask، يجب أن يكون لديك [Homebrew](https://brew.sh/) مثبتًا.
+
+```bash
+brew install --cask mark-text
+```
+
+#### ويندوز
+
+قم بتنزيل المثبّت (`marktext-setup-%version%.exe`) وتشغيله.
+
+أو، قم بتثبيت MarkText باستخدام [Chocolatey](https://chocolatey.org/). لكي تتمكن من استخدام Chocolatey، يجب أن يكون [Chocolatey](https://chocolatey.org/install) مثبتاً.
+
+```bash
+choco install marktext
+```
+
+#### لينكس
+
+يرجى الاطلاع على [تعليمات التثبيت لنظام لينكس](../LINUX.md).
+
+#### أنظمة التشغيل الأخرى
+
+تتوفر جميع إصدارات MarkText لأنظمة Linux وmacOS وWindows في [صفحة الإصدارات](https://github.com/marktext/marktext/releases/latest). إذا لم تجد إصدارًا متوافقًا مع نظامك، يُرجى فتح [تذكرة](https://github.com/marktext/marktext/issues).
+
+## التطوير
+
+إذا كنت ترغب في بناء **MarkText** بنفسك، يُرجى الرجوع إلى [دليل المطورين](../../CONTRIBUTING.md#build-instructions).
+
+- [دليل المستخدم](../README.md)
+- [دليل المطور](../dev/README.md)
+
+إذا كان لديك أي أسئلة حول **MarkText**، فلا تتردد في فتح تذكرة. يُرجى استخدام التنسيق الافتراضي عند فتح تذكرة. بالطبع، إذا قمت بتقديم طلب سحب مباشرة، فسيكون ذلك موضع تقدير كبير.
+
+## التكاملات
+
+- [Alfred Workflow](http://www.packal.org/workflow/mark-text): سير عمل لتطبيق Alfred على macOS: استخدم "mt" لفتح الملفات/المجلدات باستخدام MarkText.
+
+## المساهمة
+
+لا يزال MarkText قيد التطوير. يُرجى التأكد من قراءة [دليل المساهمة](../../CONTRIBUTING.md) قبل تقديم طلب سحب. إذا كنت ترغب في إضافة بعض الميزات إلى MarkText، فراجع [خارطة التطوير](https://github.com/marktext/marktext/projects) والقضايا المفتوحة.
+
+## المساهمون
+
+شكرًا لجميع الأشخاص الذين ساهموا بالفعل في MarkText. [[المساهمون](https://github.com/marktext/marktext/graphs/contributors)]
+
+شكر خاص لـ @[Yasujizr](https://github.com/Yasujizr) الذي صمم شعار MarkText.
+
+

+
+## الترخيص
+
+[**MIT**](../../LICENSE).
+
+[](https://app.fossa.io/projects/git%2Bgithub.com%2Fmarktext%2Fmarktext?ref=badge_large)
+
+
+