Softonic

مُنسِّق ماركداون

خطوة 1 / 2
التالي

الصق مستند ماركداون فيعيد المُنسِّق كتابته وفق نمط متسق: يصحح قفزات مستويات العناوين (لا يأتي H2 بعد H4)، ويضبط عرض أعمدة الجداول لتتحاذى في المصدر، ويفرض سطرًا فارغًا واحدًا بين الكتل، ويوحّد علامات القوائم إلى -، ويدمج سلاسل الأسطر الفارغة، ويرتّب تعريفات الروابط ذات الطابع المرجعي في الأسفل. لا يتغير HTML الناتج؛ بل يصبح ملف المصدر أكثر تنظيمًا فقط، مما يجعل الفروقات (diff) قابلة للقراءة بسهولة.

كيف يعيد المُنسِّق كتابة ماركداون

  1. 1

    الصق ماركداون

    أفلِت المستند الخام، ملف README، صفحة توثيق، ملاحظات اجتماع.

  2. 2

    اختر خيارات النمط

    علامة القائمة (`-`/`*`)، نمط العنوان (ATX/Setext)، محاذاة الجدول، عمود الالتفاف.

  3. 3

    التنسيق

    يحلّل المُنسِّق المستند إلى شجرة تركيبية (AST)، ثم يعيد كتابته بالنمط المختار.

  4. 4

    قارن الناتج

    يُظهر العرض جنبًا إلى جنب ما الذي تغيّر قبل أن تلصقه مجددًا.

ما الذي يصححه المُنسِّق

  • علامات القوائم. تُوحَّد * و- و+ جميعها إلى محرف واحد متسق (الافتراضي -).
  • هرمية العناوين. يُحذّر (أو يرفع المستوى) عندما يلي H4 عنوانَ H2 دون وجود H3 بينهما.
  • الأسطر الفارغة. سطر فارغ واحد بالضبط بين الكتل؛ دون سلاسل من ثلاثة أسطر أو أكثر.
  • الجداول. يضبط عرض كل عمود لتتحاذى الأنابيب (|) في المصدر، رغم أن محرّكات عرض ماركداون لا تكترث بذلك.
  • المسافات الزائدة في النهايات. يزيل المسافات في نهاية كل سطر، باستثناء علامة فاصل السطر المتعمَّدة المكوَّنة من مسافتين.
  • روابط الإحالة. يجمع تعريفات [label]: url في نهاية المستند، مرتَّبة أبجديًا.
  • أسوار الكود. تُوحَّد وسمة اللغة إلى حروف صغيرة؛ وتتحول كتل الكود المعتمِدة على الإزاحة إلى كتل محاطة بأسوار.

خيارات النمط التي يمكنك ضبطها

الخيار الافتراضي البدائل
علامة القائمة - *، +
نمط العنوان ATX Setext لعناوين H1/H2
فاصل التوكيد * _
فاصل الخط العريض ** __
عمود الالتفاف 0 (مُعطَّل) 80، 100، 120
ترتيب روابط الإحالة مُفعَّل مُعطَّل

لماذا يهم ماركداون المتسق

في مستودع الفريق، يُنتج ماركداون غير المتسق فروقًا مزعجة: في كل مرة يحفظ فيها أحدهم ملفًا بمحرّر مختلف تتبدل علامات القوائم وتُعاد الجداول تدفقًا. يفرض المُنسِّق نمطًا واحدًا كي لا يرى مراجعو طلبات السحب (pull request) سوى تغييرات المحتوى. اعتبره prettier للنصوص النثرية.

متى لا تُنسِّق

  • كتل الكود المحاطة بأسوار تبقى سليمة بايتًا ببايت، لن يمسّ المُنسِّق محتوى كتلة كود أبدًا. وإذا غيّر التنسيقُ الكودَ فذلك خطأ برمجي.
  • فواصل الأسطر الصلبة المتعمَّدة عند العروض الضيقة (ملف readme.md في مشروع طرفية) يُعاد التفافها إذا فعّلت عمود الالتفاف. عطّل الالتفاف إذا كنت تحتفظ بفواصل أسطر مضبوطة يدويًا.
  • كتل HTML المضمَّنة تمرّ دون تغيير.

بدائل جاهزة للاستبدال

إذا كنت تفضّل واجهة سطر أوامر محلية، يستخدم المُنسِّق قواعد الشجرة التركيبية (AST) نفسها المستخدمة في remark-stringify مع إضافة remark-gfm. كما يعطي prettier --parser markdown نتيجة مشابهة.

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

لا. يعيد المُنسِّق كتابة المصدر فقط، وينبغي أن يكون ناتج HTML المعروض متطابقًا قبل التنسيق وبعده. إذا لاحظت تغيّرًا في العرض، فأبلِغ عنه بوصفه خطأً برمجيًا.

لا. تُكتشَف الترويسة الأمامية بصيغة YAML أو TOML في أعلى الملف وتُمرَّر دون تعديل.

نعم، اضبط عمود الالتفاف على 80 أو 100 أو 120 فيُعاد التفاف الفقرات. أما الأسطر داخل أسوار الكود فلا تُمَسّ أبدًا.

لا. يفترض المُنسِّق أن روابطك تعمل؛ وهو يعيد تنظيم تعريفات روابط الإحالة فقط. استخدم أداة فحص روابط منفصلة.

لا. يجري التحليل والتنسيق داخل متصفحك؛ ولا يغادر المحتوى جهازك أبدًا.

أدوات ذات صلة

مرجع جدول ASCII

جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.

مرجع أحرف HTML

قائمة قابلة للبحث بكيانات HTML، مع رموزها المسمّاة والرقمية، بالإضافة إلى خيار النسخ بنقرة واحدة للأحرف والرموز الخاصة.

مرجع اختصارات لوحة المفاتيح

ابحث في الاختصارات الافتراضية الموثقة لـ VS Code وChrome وBash مع GNU Readline على macOS وWindows وLinux.

مولد EditorConfig

أنشئ ملف .editorconfig بقواعد نمط المسافة البادئة وحجمها ونهاية السطر ومجموعة الأحرف والمسافات البيضاء، لتنسيق موحّد عبر بيئات التطوير المتكاملة (IDEs) والمحررات.

مدقق البريد الإلكتروني

تحقق من عنوان بريد إلكتروني: فحص صياغة RFC 5322، واستعلام حي عن سجل MX، بالإضافة إلى تفاصيل الجزء المحلي والنطاق والطول. لا يتم إرسال أي بريد.

ورقة مرجعية سريعة لـ Markdown

مرجع Markdown عملي مع معاينات فعلية وأمثلة جاهزة للنسخ للعناوين والقوائم والجداول والكود والروابط والصور وصياغة GFM.

الأداة متاحة بلغات أخرى