كيفية تنسيق التعليمات البرمجية في Markdown

هناك طريقتان لتنسيق التعليمات البرمجية في Markdown. يمكنك إما استخدام التعليمات البرمجية المضمنة ، عن طريق وضع backticks (`) حول أجزاء من سطر ، أو يمكنك استخدام كتلة التعليمات البرمجية ، والتي سيطبق بعض العارضين تمييز بناء الجملة عليها.

رمز مضمّن

يمكنك استخدام تنسيق التعليمات البرمجية المضمنة للتأكيد على أمر صغير أو جزء من بناء الجملة داخل سطر تكتبه.

على سبيل المثال ، قد ترغب في ذكر Array.protoype.map()طريقة JavaScript . باستخدام تنسيق التعليمات البرمجية المضمنة ، من الواضح أن هذا جزء من التعليمات البرمجية. يمكنك أيضًا استخدامه لتوضيح أمر طرفي ، مثل yarn install.

لاستخدام تنسيق التعليمات البرمجية المضمنة ، قم ببساطة بلف الكود الذي ترغب في تنسيقه في backticks. على لوحة مفاتيح QWERTY ذات تخطيط أمريكي قياسي ، يمكن العثور عليها على يسار "1" وفوق مفتاح Tab. يتم توفير مزيد من المعلومات حول موقع backtick على لوحات المفاتيح الدولية أدناه.

على سبيل المثال ، كتابة `` Array.prototype.map () `في markdown سيعرض كـ Array.prototype.map().

كتل التعليمات البرمجية

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

لتحقيق ذلك ، ابدأ كتلتك بخط من ثلاثة تربيعات خلفية. يشير هذا إلى تخفيض السعر إلى أنك تقوم بإنشاء كتلة رمز. سوف تحتاج إلى إنهاء سطر آخر من ثلاثة باكتيكس. فمثلا:

""

var add2 = وظيفة (رقم) {

  رقم الإرجاع + 2 ؛

}

""

سيتم تقديم تخفيض السعر على النحو التالي:

var add2 = function(number) { return number + 2; }

تسليط الضوء على تركيب

على الرغم من عدم دعمه في الأصل من خلال تخفيض السعر ، فإن العديد من محركات تخفيض السعر ، بما في ذلك المحرك المستخدم بواسطة GitHub ، ستدعم تمييز بناء الجملة. هذا يعني أنه بإخبار العلامة عن اللغة التي تستخدمها داخل كتلة التعليمات البرمجية ، فإنها ستضيف ألوانًا مثل IDE.

يمكنك القيام بذلك عن طريق إضافة اسم اللغة على نفس السطر مثل علامات التجزئة الثلاثة الافتتاحية. في المثال أعلاه ، إذا كان السطر الأول هو `` يمكنك كتابة '' ، فسيتم تطبيق تمييز JavaScript على الكتلة.

var add2 = function(number) { return number + 2; }

يمكن تطبيق تمييز بناء الجملة على أكثر من مجرد جافا سكريبت. يمكنك استخدام `` html:

Hello World

روبي:

"Hello World".split('').each do |letter| puts letter end

أو `` بيثون:

a, b = 0, 1 while b < 10: print(b) a, b = a, a + b

فقط تذكر ، لن تقوم جميع محركات تخفيض السعر بتطبيق تمييز بناء الجملة.

Backticks على لوحات المفاتيح الدولية

يمكن أن يختلف موقع مفتاح backtick على لوحات مفاتيح مختلفة ، وإذا كنت لا تستخدم لوحة مفاتيح QWERTY ذات تخطيط أمريكي ، فقد يكون من الصعب العثور عليها. يسرد هذا الدليل المفيد بعض الطرق للعثور على مفتاح backtick ، ​​والذي جمعناه هنا أدناه:

QWERTY و QWERTZ:

أزيرتي: