عنوان المستند (H1)

القسم الرئيسي (H2)

القسم الفرعي (H3)

القسم الفرعي الفرعي (H4)

قسم رئيسي آخر (H2)

قسم فرعي (H3)

لا تفعل هذا:

العنوان 1

العنوان 3 (تخطي H2)

عنوان المستند

هذه مقدمة المستند.

الفصل 1

هذا محتوى الفصل 1.

1.1 قسم فرعي

هذا محتوى القسم الفرعي.

• عنصر قائمة 1
• عنصر قائمة 2

مثال على الكود:

console.log("مرحبا بالعالم");

الفصل 2

هذا محتوى الفصل 2.

في هذا المقال، سنناقش استخدام Markdown
وكيفية تطبيقه على GitHub.

سنذكر أيضاً أفضل ممارسات Stack Overflow.

الفوائد:

1. إدارة مركزية للروابط
2. تجربة قراءة أنظف
3. صيانة أسهل

توثيق المشروع

• البداية السريعة
• توثيق API
• الأسئلة الشائعة

مراجع الصور:

مزايا المسارات النسبية:

• سهولة نقل المستندات
• دعم التصفح دون اتصال
• تقليل تكلفة الصيانة

الممارسة الجيدة:

function calculateSum(a, b) {
  return a + b;
}

def calculate_sum(a, b):
  return a + b

تجنب هذا:

function calculateSum(a, b) {
  return a + b;
}

// برمجية وسطى لمصادقة المستخدم
function authenticateUser(req, res, next) {
  // الحصول على الرمز المميز من رؤوس الطلب
  const token = req.headers.authorization;
  
  if (!token) {
      // إرجاع خطأ 401 إذا لم يوجد رمز مميز
      return res.status(401).json({ error: 'لم يتم توفير رمز مميز' });
  }
  
  try {
      // التحقق من صحة الرمز المميز
      const decoded = jwt.verify(token, process.env.JWT_SECRET);
      req.user = decoded;
      next();
  } catch (error) {
      // التعامل مع الرمز المميز غير الصالح
      return res.status(403).json({ error: 'رمز مميز غير صالح' });
  }
}

التنسيق الموصى به:

مقبول أيضاً (نفس الوظيفة):

الممارسة الجيدة:
هذه فقرة بطول مناسب. ليست طويلة جداً لتكون
صعبة القراءة، وليست قصيرة جداً لتبدو مجزأة.

تجنب:
هذه فقرة طويلة جداً جداً جداً جداً جداً جداً جداً جداً جداً جداً جداً جداً جداً جداً جداً ستجعل القراء متعبين وصعبة لتتبع موضع القراءة.

تجنب أيضاً:
قصيرة جداً.
فقرات.
صعبة القراءة.

ميزات المشروع

مشروعنا يحتوي على الميزات التالية:

• أداء عالي: خوارزميات وبنى بيانات محسنة
• سهولة الاستخدام: تصميم API بديهي
• قابلية التوسع: بنية قائمة على المكونات الإضافية
• متعدد المنصات: دعم لأنظمة تشغيل متعددة

متطلبات التثبيت

قبل البدء، تأكد من أن نظامك يلبي هذه المتطلبات:

1. Node.js إصدار >= 14.0.0
2. npm إصدار >= 6.0.0
3. نظام التشغيل: Windows 10+، macOS 10.15+، Ubuntu 18.04+
4. الذاكرة: على الأقل 4GB RAM

الممارسة الجيدة:
هذه هي الجملة الأولى.
هذه هي الجملة الثانية.
هذه هي الجملة الثالثة.

تجنب:
هذه هي الجملة الأولى. هذه هي الجملة الثانية. هذه هي الجملة الثالثة.

المزايا:

• فروقات Git أوضح
• تتبع أسهل للتغييرات
• تقليل تعارضات الدمج

docs/
├── en/
│ ├── README.md
│ ├── getting-started.md
│ └── api.md
├── zh/
│ ├── README.md
│ ├── getting-started.md
│ └── api.md
└── README.md # مستند رئيسي يربط بإصدارات اللغات

أضف مبدل اللغة لكل مستند:

• English
• 中文

إرشادات استخدام الصور

الصور المحلية

الصور عبر الإنترنت (تأكد من الاستقرار)

ضغط الصور الكبيرة

للصور الكبيرة، فكر في:

• استخدام دقة مناسبة
• اختيار تنسيق مناسب (WebP، PNG، JPEG)
• توفير إصدارات بأحجام متعددة

أضف نص بديل

جميع الصور يجب أن تحتوي على نص بديل وصفي،
وهو مهم لسهولة الوصول وSEO.

عنوان المستند - واضح لتحويل النص

قسم مع عناوين صديقة للنص

قسم فرعي: سهل القراءة في تنسيق النص

استخدم تنسيقاً متسقاً يتحول بنظافة:

• النقاط تحافظ على البنية في إخراج تحويل markdown إلى نص
• اجعل أطوال الفقرات معتدلة للقابلية للقراءة
• استخدم عناوين واضحة ووصفية للتنقل في النص

التأكيد العريض يعمل جيداً في تحويل النص.
النص المائل محفوظ في معالجة تحويل markdown إلى نص.

كتل الكود توفر سياقاً حتى في تنسيق النص
مثالية لسير عمل توثيق تحويل markdown إلى نص

الاقتباسات المربعة تحافظ على المعنى في تحويل النص
مفيدة لتسليط الضوء على المعلومات المهمة

الروابط مثل محول MD إلى نص
تبقى قابلة للوصول في إخراج النص.

الأدوات الموصى بها لسير عمل تحويل Markdown إلى نص

محررات تحويل النص

• Typora: محرر WYSIWYG مع تصدير نص ممتاز
• Mark Text: معاينة في الوقت الفعلي مع إخراج نص نظيف
• VS Code: امتدادات Markdown محسنة لتحويل النص
• Obsidian: تدوين الملاحظات مع قدرات تحويل markdown إلى نص فائقة

أدوات محول Markdown

• Pandoc: محول مستندات عالمي مع إخراج نص
• Marked: معالجة سريعة لتحويل markdown إلى نص
• Turndown: تحويل HTML إلى markdown لسير عمل النص
• Remark: معالج markdown قوي لتحويل النص

منصات معالجة النص

• GitBook: توثيق مع تصدير نص نظيف
• VuePress: مولد موقع ثابت مع دعم تحويل markdown إلى نص
• Gatsby: منصة قائمة على React مع قدرات تحويل markdown إلى نص
• Docusaurus: منصة Facebook محسنة لإخراج النص

أدوات تحويل النص عبر الإنترنت

• محول MD إلى نص: معالجة متخصصة لتحويل markdown إلى نص
• StackEdit: محرر عبر الإنترنت مع ميزات تصدير النص
• Dillinger: محرر markdown سحابي مع إخراج نص نظيف
• معاينة Markdown المباشرة: معاينة تحويل النص في الوقت الفعلي

معالجة النص من سطر الأوامر

• Pandoc CLI: تحويل markdown إلى نص من سطر الأوامر
• Marked CLI: معالجة نص سريعة من markdown
• Remark CLI: سير عمل تحويل نص متقدم
• سكريبتات مخصصة: معالجة مجمعة آلية لتحويل markdown إلى نص