Markdown إلى HTML

يقوم محول Markdown إلى HTML بتحويل مصدر Markdown - README، أو سجل التغيير، أو مسودة مدونة، أو مجموعة من ملاحظات الإصدار - إلى متصفح HTML أو يعرضه CMS. الصق أو اكتب Markdown على اليسار، وستحصل على HTML الدلالي على اليمين: تصبح العناوين h1 pherh6، ويصبح الكود المسيج مسبقًا ويتم التعامل مع التعليمات البرمجية مع فئة اللغة، وتصبح القوائم ul وol، ويتم التعامل مع امتدادات GitHub مثل الجداول وقوائم المهام والشطب بالطريقة التي يعرضها بها GitHub.

Markdown هو تنسيق كتابة نص عادي، وليس تنسيق عرض. في أي مكان يظهر على الصفحة - موقع المستندات، أو مدونة ثابتة، أو قالب بريد إلكتروني، أو حقل CMS الذي يقبل HTML فقط - يجب على شيء ما تجميعه أولاً. يعد القيام بذلك في المتصفح، بدلاً من سحب محلل إلى الإصدار الخاص بك أو لصق المسودة في خدمة لا تتحكم فيها، أسرع طريقة للحصول على العلامات والمضي قدمًا.

كل شيء يعمل من جانب العميل. المحول عبارة عن محلل مكتوب بخط اليد ، وليس غلافًا حول واجهة برمجة تطبيقات بعيدة ، لذا فإن مشاركاتك غير المنشورة والمستندات الداخلية وملاحظات الإصدار الخاصة لا تغادر الصفحة أبدًا. قم بتبديل Markdown بنكهة GitHub ، وتحديد معرفات الربط ، وفاصل سطر واحد جديد وتمرير HTML الخام ، ثم انسخ HTML ، أو تنزيل ملف .html ، أو احصل على جدول محتويات تم إنشاؤه.

يوضح المثال القصير العملي ما تحصل عليه عند تحويل Markdown إلى HTML هنا. لصق `# My Project`، ثم `##Install`، ثم قائمة مهام مكونة من صفين `-[x] Done` و`-` [] Todo`. الإخراج هو ` in` with [my-project">My Project</h1>`، ``<h2 id="install">Install</h2>` and a` `<ul class="task-list">`` w` in doctype with ``<title>My Project</title>`. إنه محول Markdown إلى HTML مجاني، بدون تسجيل، ويتحول كما تكتب.

يسمح Markdown بتضمين HTML الخام، مما يجعل سؤال السلامة حقيقيًا وليس نظريًا: المستند الذي يحتوي على علامة البرنامج النصي صالح Markdown، والمحول الذي يمررها ينتج HTML الذي سيتم تشغيله عند عرضه. يتم الهروب من الإخراج هنا افتراضيًا لهذا السبب، لذلك لا يمكن لملف Markdown من مصدر غير موثوق به تهريب العلامات إلى صفحتك. الروابط هي حالة منفصلة: رابط `javascript:` in the Markdown يحتفظ بهذا المرجع في HTML المنسوخ، وجزء المعاينة فقط يعيد كتابته، لذا قم بتطهير الإخراج قبل نشر Markdown الذي لم تكتبه. إذا كنت تقوم بتحويل المحتوى الخاص بك وتريد الحفاظ على HTML الخام، فهذا اختيار متعمد وليس الافتراضي. والشيء الآخر الذي يجب معرفته هو أن Markdown ليس له مواصفات واحدة. يتم تنفيذ GitHub Flavored Markdown هنا، والذي يغطي الجداول وقوائم المهام والشطب والتعليمات البرمجية المسيجة، وهذه امتدادات وليست جزءًا من بناء الجملة الأصلي، لذلك لن يعرضها عارض CommonMark الصارم.