تخطي إلى المحتوى الرئيسي
التحليل

محلل بنية Markdown

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

أدوات Markdown

باختصار

يعطي محلل regex مؤشرات تحريرية لا AST كاملًا: يستبعد الكود من الكلمات، ويجمع الصور مع الروابط، ويحسب أحرف JavaScript كـUTF-16.

ما الذي تدعمه الأداة

  • يحسب الكلمات بعد إزالة code fences وinline code والصور وعلامات Markdown ووجهات الروابط مع إبقاء نص الرابط.
  • يعرض أحرف المصدر وغير الفراغية والأسطر الفعلية والفقرات المفصولة بسطر فارغ وعناوين ATX من # إلى ######.
  • يجمع الروابط والصور بنمط واحد ويقدّر كتل الكود كأزواج من علامات ```.
  • يحسب ceil(words/220)، ودقيقة واحدة على الأقل لأي نص غير صفري؛ يدعم التحليل الحي/اليدوي واستيراد الملف.

كيفية استخدام محلل بنية Markdown

اتبع سير العمل الخاص بتنفيذ محلل بنية Markdown؛ فكل خطوة تعكس عناصر التحكم والحدود الفعلية في مساحة عمل المتصفح.

  1. 1

    الخطوة 1

    أدخل المصدر بدقة

    ألصق أو اكتب أو استورد مصدر Markdown الدقيق المراد قياسه.

  2. 2

    الخطوة 2

    اختر العملية

    اترك Live للأرقام المستمرة، أو عطّله واضغط Analyze لأخذ لقطة ثابتة.

  3. 3

    الخطوة 3

    اضبط الخيارات المتاحة

    شغّل محلل regex ولا تفترض أنه يبني شجرة صياغة Markdown كاملة.

  4. 4

    الخطوة 4

    نفّذ العملية محليًا

    راجع الكلمات والأحرف والأسطر والفقرات والعناوين والروابط/الصور وأزواج الأسوار وتقدير 220 كلمة/دقيقة مقابل المصدر.

  5. 5

    الخطوة 5

    تحقق من النتيجة ثم تابع

    استخدم معاينة Markdown لفحص الهرمية بصريًا وسجل اللقطة إذا كانت الإحصاءات بوابة نشر.

الأخطاء الشائعة

اعتبار عدد الروابط خاصًا بالروابط فقط

النتيجة: يطابق النمط [text](url) و![alt](url)، فتزيد الصور العداد نفسه.

الإصلاح: افحص المصدر أو استخدم parser عندما يلزم فصل الصور والروابط.

اعتبار عدد الأحرف عدد graphemes للمستخدم

النتيجة: يحسب string.length وحدات UTF-16؛ قد يحسب emoji والحروف المركبة أكثر من رمز مرئي.

الإصلاح: استخدم محلل Unicode واعيًا بـgrapheme عند فرض حد مرئي.

اعتبار زوج backticks دليل كتلة صحيحة

النتيجة: القيمة floor(عدد ``` /2)، وقد تخطئ مع أسوار ناقصة أو متداخلة.

الإصلاح: تحقق بمحلل Markdown حقيقي واستخدم الرقم كمؤشر فقط.

أفضل الممارسات

  • قارن الإحصاءات بمعاينة مرسومة قبل فرض قواعد النشر.
  • وثّق افتراض 220 كلمة/دقيقة إذا عرضت زمن القراءة للمستخدم.
  • استخدم مصدرًا ثابتًا وأداة parser عند الحدود التعاقدية.

سير العمل المرتبط

قيود المتصفح

  • regex لا parser: قد يسيء تصنيف escapes وHTML وreference links والكود المزاح والأسوار غير العادية.
  • الأحرف وحدات UTF-16 والفقرات مجموعات أسطر فارغة، ولا تُحسب عناوين Setext.
  • تُعالج كل السلسلة تزامنيًا على main thread ولا يوجد تنزيل تقرير أو مقارنة تاريخية.

المراجع الموثوقة

CommonMark Specification 0.31.2الناشر: CommonMark · تاريخ المراجعة: 2026-07-26

أمثلة عملية

الإدخال
# العنوان مرحبًا بالعالم. [التوثيق](https://example.com)
النتيجة
يحسب عنوان ATX واحدًا ورابطًا واحدًا وثلاث مجموعات فقرات وأربع كلمات.

تُحذف وجهة الرابط ويبقى نصه كلمة؛ تُقرب أربع كلمات إلى دقيقة واحدة عند 220 كلمة/دقيقة. تعتمد قيمة الأحرف على وحدات UTF-16 للنص العربي المحدد.

الأسئلة الشائعة

هل تدخل أسوار الكود والكود المضمن في الكلمات؟

لا. تُستبدل كتل ``` ومقاطع `...` بفراغ قبل تقسيم الكلمات.

لماذا تُحسب الصورة ضمن بطاقة الروابط؟

لأن التعبير المنتظم يسمح بعلامة تعجب اختيارية فيجمع صيغتي الصورة والرابط.

هل تُحسب عناوين Setext ذات الخط السفلي؟

لا. يختار headingOutline أسطرًا تبدأ من # إلى ###### ثم فراغ ومحتوى فقط.

ماذا يعني عدد الأحرف مع emoji؟

وحدات UTF-16 في JavaScript، لا code points أو grapheme clusters المرئية.

كيف يُحسب زمن القراءة؟

صفر كلمات يعطي صفرًا؛ وإلا ceil(words/220) بحد أدنى دقيقة.

الخصوصية والعمل دون اتصال

يُحلل Markdown داخل المتصفح فقط ولا يُرفع أو يُحفظ بواسطة المساحة. تُقرأ الملفات بعد اختيارها، ويعمل التحليل دون اتصال بعد التخزين.