GitBook is a hosted solution for documentation websites and knowledge bases. In a nutshell, you sign in to GitBook’s website and use their web-based editor to write your documentation. Or, if you’d rather maintain control over your content, you can keep it in a GitHub repository that is integrated with GitBook. Either way, you can create different webpages and organize them in a logical order. When everything looks the way you want it, you can publish it on a custom domain.

Like so many projects, GitBook started as an open source toolchain with a commercial offering, but eventually dropped the open source project in favor of a new proprietary and closed-source offering that’s hosted exclusively on their website. The open source toolchain is still available, but as that option is now unsupported, this article only documents the new hosted option.

The advantage of GitBook over a tool like Docusaurus is that GitBook takes care of building and hosting the site, and the WYSIWYG controls are intuitive enough to be used by Markdown novices. On the GitBook website, the live editor hides the Markdown formatting syntax after you type it. The editor is a bit flaky, but weird little bugs aside, the website generally works for both Markdown experts and people who don’t have any experience with Markdown. You can also simply copy and paste Markdown-formatted text into the GitBook interface.

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

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

العناصر الدعم ملاحظة
العناوين نعم
الفقرات نعم
فواصل الأسطر نعم
سُمْك النص نعم
إمالة النص نعم
الاقتباسات نعم
القوائم المرقّمة (المرتّبة) نعم
القوائم المنقّطة (غير المرتّبة) نعم
الأكواد البرمجية نعم
فواصل الأسطر لا
الروابط نعم
الصور نعم
الجداول نعم
الكتل البرمجية المسوّرة نعم
تلوين الأكواد البرمجية نعم
الحواشي السفلية لا
معرفّات العنوان نعم
قوائم التعريف لا
النص المشطوب نعم
قوائم المهام نعم
نسخ ولصق الرموز التعبيرية غير معروف
الرموز التعبيرية (الإيموجي) غير معروف
الربط التلقائي للروابط نعم
تعطيل الربط التلقائي للروابط نعم

تصفح أيضا

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

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