مولد كتل الكود بصيغة Markdown
ضع الكود داخل كتلة كود Markdown باللغة الصحيحة لتلوين الصيغة، واختر علامة الإحاطة، واجعلها قسما قابلا للطي إن أردت.
جارٍ تحميل مولد كتل الكود بصيغة Markdown…
ملفاتك لا تغادر جهازك أبدًا
طريقة استخدام مولد كتل الكود بصيغة Markdown
- 1
افتح مولد كتل الكود بصيغة Markdown في هذه الصفحة. تُحمَّل مباشرة في متصفحك.
- 2
أضف ملفك أو نصك أو القيم، واضبط الإعدادات.
- 3
انسخ النتيجة أو نزّلها. لا يُرفع أي شيء ولا يُخزَّن.
عن هذه الأداة
مشاركة الكود في README أو مشكلة GitHub أو Discord أو Stack Overflow تكون أفضل داخل كتلة كود محاطة مع تحديد اللغة، فيحافظ على تنسيقه ويحصل على تلوين الصيغة. يحيط مولد كتل الكود بصيغة Markdown هذا الكود بشكل صحيح، حتى عندما يحتوي الكود نفسه على علامات backtick، ويمكنه وضع المقاطع الطويلة في قسم قابل للطي.
طريقة إنشاء كتلة كود
- الصق الكود.
- اختر اللغة، مثل JavaScript أو Python أو Bash أو JSON أو SQL.
- اختر علامة الإحاطة: ثلاث علامات backtick، أو علامات تلدة عندما يحتوي الكود على backtick.
- فعّل إن شئت قسما قابلا للطي واكتب نص ملخصه.
- راجع المعاينة وانسخ Markdown.
ما الذي ينتجه
```python
print("Hello")
```
اسم اللغة بعد علامة الإحاطة الافتتاحية يخبر GitHub وGitLab وDiscord وأدوات التوثيق بكيفية تلوين الكود.
كود قابل للطي
السجلات الطويلة وملفات الإعدادات قد تغطي بقية المشكلة. يضع خيار الطي الكتلة داخل عنصر details مع ملخصك كعنوان قابل للنقر، مثل "سجل الأخطاء الكامل"، ليفتحه القراء عند الحاجة.
نصائح
- حدد اللغة دائما؛ فهي تجعل الكود أسهل قراءة بكثير.
- استخدم diff كلغة لإظهار الأسطر المضافة والمحذوفة بالعلامتين + و-.
- اختصر المخرجات الطويلة إلى الجزء المهم قبل مشاركتها.
- احذف الأسرار مثل مفاتيح API وكلمات المرور من الكود قبل نشره.
للمزيد عن Markdown راجع مرجع Markdown السريع، أو اكتب مستندا كاملا في محرر Markdown.
الأسئلة الشائعة
كيف أضيف كتلة كود في Markdown؟
ضع ثلاث علامات backtick في السطر قبل الكود وبعده، واكتب اسم اللغة بعد الثلاث الأولى مباشرة، مثل ```javascript.
كيف أعرض كودا يحتوي على backtick؟
استخدم علامة إحاطة أطول أو علامات تلدة (~~~) حول الكتلة، ويمكن للمولد فعل ذلك، حتى لا تغلق علامات backtick الداخلية الكتلة.
ما اللغات التي تُلوَّن؟
يقوم بالتلوين الموقع الذي يعرض Markdown الخاص بك. يدعم GitHub وGitLab ومعظم الأدوات اللغات الشائعة مثل JavaScript وPython وBash وJSON وSQL.
كيف أصنع كتلة كود قابلة للطي؟
فعّل خيار الطي وأدخل ملخصا. تُحاط الكتلة بعنصر details يستطيع القراء توسيعه.
كيف أعرض الفروق (diff)؟
استخدم diff كلغة وابدأ الأسطر المعدلة بـ + أو -. تظهر بالأخضر والأحمر على GitHub.
هل يعمل في Discord وSlack؟
يدعم Discord كتل الكود المحاطة مع اللغة. ويدعم Slack كتل الكود لكن دون تلوين حسب اللغة.