---
title: Writing a Markdown File for GitHub Using Atom
localeTitle: كتابة ملف Markdown ل GitHub باستخدام Atom
---
يمثل Markdown طريقة لتصميم النص على الويب ، ويستفيد مستخدمو GitHub من الترقيم لتوفير الوثائق لمستودعاتهم.

من [أدلة GitHub](https://guides.github.com/features/mastering-markdown/) :

> يمكنك التحكم في عرض المستند. إن تنسيق الكلمات على شكل غامق أو مائل ، وإضافة الصور ، وإنشاء القوائم ليست سوى عدد قليل من الأشياء التي يمكننا القيام بها باستخدام Markdown. في الغالب ، Markdown هو مجرد نص عادي مع عدد قليل من الأحرف غير الأبجدية القيت ، مثل # أو \*.
> 
> يمكنك استخدام Markdown في معظم الأماكن حول GitHub:
> 
> *   جوهر
> *   التعليقات في القضايا وطلبات السحب
> *   الملفات ذات الامتداد .md أو .markdown
> 
> ملفات `.md` السعر تحتوي على الامتداد `.md` وسترى أن عددًا كبيرًا من مستودعات GitHub بها ملفات `README.md` .

مثال رائع هو أنك إذا أردت كتابة ملف Wiki لهذا المستودع ، فستحتاج إلى أن يكون ملف `.md` . ما تقرأه الآن هو ملف `writing-a-markdown-file-using-atom.md` يسمى " `writing-a-markdown-file-using-atom.md` ملف `writing-a-markdown-file-using-atom.md` .

ملفات تخفيض السعر سهلة الكتابة ، ويمكنك العثور على ورقة الغش تخفيض السعر [هنا](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) .

## إنشاء ملف التمهيدي على جيثب

يمكنك إنشاء ملف README.md على GitHub نفسه:

![لقطة شاشة 2016-02-29 في 18 07 19](//discourse-user-assets.s3.amazonaws.com/original/2X/9/9a1d7f226df87df437f616fcaf5b7adcf02c8e87.png)

يمنحك ذلك القدرة على التبديل بين طرق عرض "تعديل ملف جديد" و "معاينة":

![لقطة شاشة 2016-02-29 في 18 06 24](//discourse-user-assets.s3.amazonaws.com/original/2X/e/e0b3ddb69c3f2c32c0c7e73f1b1d196a54f03c21.png)

هذا مثالي إذا كان الملف التمهيدي الخاص بك صغيرًا ، ولا تمانع في التبديل بين طريقتي العرض.

ولكن ماذا لو لم يكن ملف `.md` الخاص بك `.md` ، وتريد ترف العمل في محرر نصوص ومعاينة مباشرة لما يبدو عليه نصك في نفس الوقت الذي تقوم فيه بتحريره؟

## كتابة ملفات تخفيض السعر باستخدام Atom

إذا كنت تكتب ملفًا تقريبًا طويلًا أو مفصلاً ، فسيساعدك ذلك في الحصول على معاينة مباشرة لما يبدو عليه شكلك الشعار ، تمامًا كما قد تستخدم إمكانات إعادة التحميل المباشر لتحديث متصفحك إذا كنت تعمل في مشروع يستخدم HTML و CSS ، على سبيل المثال.

هناك طريقة جيدة للانطلاق نحو إنشاء ملف تخفيض السعر يستخدم [محرر نص Atom](https://atom.io/) . يمكنك تثبيت Atom واستخدامه مجانًا.

تستخدم Atom ، مثل برامج تحرير النصوص الأخرى ، الحزم ، وهي أجزاء من التعليمات البرمجية التي تسمح لك بتخصيص سير العمل الخاص بك.  
1\. أولاً ، سترغب في تثبيت محرر نص Atom من [هنا](https://atom.io/) .  
2\. عندما يتم تثبيت Atom ، افتحه ، وافتح ملفًا جديدًا `.md` .  
3\. لمشاهدة المعاينة المباشرة ، انقر بزر الماوس الأيمن فوق ملف `.md` الخاص بك من المستكشف الموجود على اليمين ، ثم حدد الخيار العلوي ، "معاينة تخفيض السعر":

![لقطة شاشة 2016-02-29 في 18 17 30](//discourse-user-assets.s3.amazonaws.com/original/2X/e/ea3746446180c0e0ad2bb61f30a6c3ad8bc25c57.png)

رائع! يجب أن تشاهد الآن جزأين في Atom. على اليسار يوجد النص الخاص بك ، وعلى اليمين هو تخفيض السعر "المجمع" ، أي ما قد يبدو عليه على GitHub:

![لقطة شاشة 2016-02-29 في 18 21 38](//discourse-user-assets.s3.amazonaws.com/original/2X/a/a1f27aa8afe060e252f245ced3456f196c85ef1b.png)

لاحظ أن Atom يتعرف أيضًا على ما تعمل معه ليكون تنسيقًا محددًا ، أي "GitHub Markdown":

![لقطة شاشة 2016-02-29 في 19 15 43](//discourse-user-assets.s3.amazonaws.com/original/2X/c/cf5b2fc473c32a14a2de302fd88e4c2edde02453.png)

1.  عندما يكون ملف تخفيض السعر الخاص بك جاهزًا للالتزام بمستودع GitHub ، يمكنك المضي قدمًا وإلزامه!

للمساهمة في ويكي FreeCodeCamp ، انتقل إلى [هذه الصفحة](https://github.com/FreeCodeCamp/freecodecamp/wiki) واطلع على قسم "أدلة حول كيفية المساهمة".

لإضافة مشروع أو ملفات إلى GitHub ، انتقل إلى [هذه الصفحة](https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/) .

**خطوة إضافية:** تحتوي Atom على حزمة باسم [Markdown Preview Plus](https://atom.io/packages/markdown-preview-plus) . وهو يفعل نفس طريقة المعاينة العادية للضغط ، ولكن يتم تصميم ملف المعاينة بشكل أكثر دقة على نمط GitHub. المضي قدما وتثبيت هذه الحزمة ونرى ما تحصل عليه.