Jekyll is a static site generator that takes Markdown files and converts them to a website. Jekyll is a free and open-source application written in the Ruby programming language. Thousands of websites, including the Markdown Guide, rely on Jekyll to convert Markdown source files to HTML output. GitHub Pages uses Jekyll as the backend for its free website creation service.

By default, Jekyll uses the kramdown Markdown processor with stock settings, but you can enable other kramdown options or even switch Jekyll to another Markdown processor. See the Jekyll Markdown configuration options documentation for more information. You can change Jekyll’s kramdown settings in the _config.yml file. The settings for the Markdown Guide are shown below.

kramdown:
  syntax_highlighter: rouge
  input: GFM
  auto_ids: true
  toc_levels: 1..3

دعم Jekyll للماركداون

Jekyll يوفر الدعم لعناصر ماركداون التالية.

العناصر الدعم ملاحظة
العناوين نعم
الفقرات نعم
فواصل الأسطر نعم
سُمْك النص نعم
إمالة النص نعم
الاقتباسات نعم
القوائم المرقّمة (المرتّبة) نعم
القوائم المنقّطة (غير المرتّبة) نعم
الأكواد البرمجية نعم
فواصل الأسطر نعم
الروابط نعم
الصور نعم
الجداول نعم
الكتل البرمجية المسوّرة نعم
تلوين الأكواد البرمجية نعم Make sure that syntax_highlighter: rouge is in the kramdown section of the _config.yml file.
الحواشي السفلية نعم
معرفّات العنوان نعم
قوائم التعريف نعم
النص المشطوب نعم You can use two tildes (~~word~~) or one tilde (~word~) — both work.
قوائم المهام نعم
نسخ ولصق الرموز التعبيرية نعم
الرموز التعبيرية (الإيموجي) لا Not supported by default, but you can use the jemoji plugin to enable support.
الربط التلقائي للروابط نعم
تعطيل الربط التلقائي للروابط نعم
HTML نعم

Support for Additional Syntax Elements

As an added bonus, Jekyll provides support for several obscure elements.

Element Markdown Rendered Output
Abbreviation *[HTML]: Hyper Text Markup Language
The HTML specification is maintained by the W3C.
The HTML specification is maintained by the W3C.

تصفح أيضا

هل تريد معرفة المزيد عن Markdown؟

لا تتوقف الآن! 🚀 قم بتمييز مستودع GitHub بنجمة ثم أدخل عنوان بريدك الإلكتروني أدناه لتلقي دروس Markdown التعليمية الجديدة عبر البريد الإلكتروني. نحن لا نرسل بريدا مزعجا!