Markdown للكتاب التقنيين

## لماذا Markdown؟

خمسة أسباب للتبديل

• —

  مناسبة للتحكم بالإصدارات. يعمل git diff مع ملفات .md ويعرض كل تغيير بوضوح.

• —

  قابلة للنقل. ملفات Markdown نص عادي، غير مقفلة على منصة أو مزود أو اشتراك.

• —

  بسيطة الصيغة. يمكنك تعلمها في عشر دقائق: عناوين، غامق، مائل، روابط، قوائم، كتل كود، وجداول.

• —

  مستقبلية. النص العادي لا يصبح غير مقروء مع الزمن. الملفات التي تكتبها اليوم ستظل قابلة للفتح بعد سنوات طويلة.

• —

  تعاونية. يمكن مراجعة تغييرات Markdown بسهولة داخل pull requests، ودمج التوثيق مع الكود بشكل طبيعي.

## سير العمل

اكتب، عاين، انسخ، انشر

## ما الذي يهم الكتاب التقنيين؟

ما الذي يحتاجه محرر المعاينة؟

## Markdown مقابل WYSIWYG

لماذا لا نستخدم Google Docs فقط؟

Google Docs وWord جيدان جدا للتعاون، لكنهما ينهاران في سير العمل القريب من التطوير:

• —

  التحكم بالإصدارات. لا يمكنك عمل diff على مستند Google Docs، ولا مراجعته في pull request بسهولة.

• —

  قابلية النقل. التصدير يعطيك غالبا ملفات .docx أو .pdf مع فقدان بعض الدقة.

• —

  سير العمل التطويري. عندما تعيش الوثائق بجانب الكود، تصبح Markdown أكثر انسجاما مع الفريق.

Markdown لا تستبدل أدوات التعاون؛ إنها تكملها. اكتب بها، عاين محليا، وشارك الناتج المنسق عندما يحتاج الآخرون إلى المراجعة.

## البداية

ابدأ الكتابة اليوم

إذا كنت جديدا على Markdown، فالصيغة سهلة التعلم. لدينا مرجع كامل: ورقة Markdown المرجعية.

وللمعاينة على Mac، جرّب ShowMeMyMD. اكتب في المحرر الذي تريده، عاين الملف، ثم انسخ الناتج المنسق عند الحاجة.

## اقرأ المزيد

• ورقة Markdown المرجعية — كل اختصارات الصياغة في مكان واحد
• نسخ Markdown كنص منسق — الصق المستندات المنسقة في أي تطبيق
• ShowMeMyMD: عارض Markdown على Mac — نظرة كاملة على الميزات
• ما هو ملف .md؟ — دليل مبسط لملفات Markdown