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 فيُعاد التفاف الفقرات. أما الأسطر داخل أسوار الكود فلا تُمَسّ أبدًا.

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

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

أدوات ذات صلة

مولّد إعدادات Webpack

أنشئ ملف webpack.config.js لـ webpack 5 من نموذج قصير: حدّد entry ومجلد الإخراج والوضع (mode)، ثم فعّل TypeScript وBabel ومحمّل CSS وHtmlWebpackPlugin وخادم تطوير.

مرجع جدول ASCII

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

محوّل ترميز ملفات النصوص

حوّل النص بين UTF-8 وUTF-16 وLatin-1 وWindows-1252 وترميزات أخرى لإصلاح الأحرف المشوّهة.

مولّد ملف .gitignore

اجمع قواعد استبعاد المشروع لـ Laravel وNode.js وPython وRails. انسخ الناتج أو نزّل ملف ZIP يحتوي على .gitignore، مع إبقاء القواعد الشخصية منفصلة.

مولد ملف tsconfig.json

أنشئ ملف tsconfig.json نظيفا باختيار target وmodule وmoduleResolution وJSX وأعلام الصرامة الشائعة، ثم انسخ الإعداد المولّد إلى مشروعك.

مُحقق تنسيق XSD

قم بالتحقق من وثيقة XML وفقًا لمخطط XSD، وعرض أي اختلافات بين العناصر وأنواعها مع تحديد أرقام السطور بدقة.

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