محول مجاني

Markdown to HTML Converter

Transform Markdown text into production-ready HTML code with live preview support.

حول هذه الأداة

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

يستخدم هذا المحول المكتبة المميزة، وهي عارض Markdown الأكثر استخدامًا على نطاق واسع في JavaScript. يدعم Marked CommonMark وGitHub Flavoured Markdown (GFM)، مما يعني أن الجداول وكتل التعليمات البرمجية المسيجة وقوائم المهام والخط المتوسط ​​والربط التلقائي جميعها تعمل بشكل صحيح بالإضافة إلى ميزات Markdown القياسية.

الإخراج هو HTML عادي - علامات دلالية للعناوين والفقرات والقوائم والروابط والصور، بالإضافة إلى خطافات الفصل لكتل التعليمات البرمجية حيث تتوقعها أدوات تمييز بناء الجملة. يتم لصق الإخراج بشكل نظيف في أي نظام إدارة محتوى (CMS)، أو يتم تضمينه في مولدات المواقع الثابتة، أو يعمل كملف .html مستقل. لا تتم إضافة CSS أو JavaScript؛ التصميم يتم ترك النتيجة للسياق الخاص بك.

لماذا تحويل Markdown إلى HTML

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

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

كيفية الاستخدام

لصق تخفيض السعر، واحصل على HTML.

  1. أضف تخفيض السعر الخاص بك: قم بلصق نص Markdown في منطقة الإدخال أو قم بإسقاط ملف .md. يعمل كل من بناء جملة Markdown وGitHub Flavoured Markdown القياسي.
  2. تحويل: يقوم Marked بتوزيع Markdown إلى AST ويصدر HTML. يتم عرض العناصر المضمنة القياسية (التأكيد، القوية، الروابط، التعليمات البرمجية، الصور)، وعناصر الكتلة (العناوين، والفقرات، والقوائم، وعلامات الاقتباس)، وامتدادات GFM (الجداول، والتعليمات البرمجية المسيجة، وقوائم المهام، والارتباطات التلقائية) بشكل صحيح.
  3. معاينة: افحص HTML المعروض في لوحة المعاينة. تأكد من ظهور كتل التعليمات البرمجية والجداول والعناصر المعقدة الأخرى كما هو متوقع.
  4. نسخ أو تنزيل: انسخ HTML إلى الحافظة للصقه في نظام إدارة المحتوى (CMS)، أو احفظه بتنسيق .html للاستخدام المستقل. الإخراج هو HTML5 الدلالي بدون أنماط مضمنة.

حالات الاستخدام الشائعة

التفاصيل الفنية

يستخدم Marked بنية ثنائية المرور. يقوم المعجم بترميز الإدخال في الرموز المميزة على مستوى الكتلة (العناوين والفقرات والقوائم وكتل التعليمات البرمجية) والرموز المميزة المضمنة (التوكيد والروابط والصور). يسير المحلل اللغوي في دفق الرمز المميز ويصدر HTML، مع تطبيق خطافات العارض لكل نوع رمز مميز.

يتم تمكين ملحقات GitHub Flavoured Markdown بشكل افتراضي: الجداول (باستخدام بناء الجملة)، وكتل التعليمات البرمجية المسيجة (علامات خلفية ثلاثية مع تلميحات اللغة)، وقوائم المهام (- [ ] و - [x])، ويتوسطه خط (باستخدام علامات التلدة المزدوجة)، والربط التلقائي لعنوان URL. تُصدر كتل التعليمات البرمجية ملفوفة مسبقًا حول التعليمات البرمجية مع فئة لغة اختيارية لتسليط الضوء على بناء الجملة النهائي.

يتم ترك تعقيم المخرجات للمستهلكين في المراحل النهائية. يُصدر Marked كل ما ينتج عن المدخلات، بما في ذلك HTML الخام المضمن في Markdown. إذا قبلت إدخالاً غير موثوق به، فقم بتشغيل الإخراج من خلال DOMPurify أو مطهر HTML مماثل قبل العرض في المتصفح.

أفضل الممارسات

الأسئلة الشائعة

هل يؤدي تحويل MARKDOWN إلى HTML إلى تغيير المحتوى؟
يتم الحفاظ على المحتوى بأكبر قدر ممكن من الدقة. ومع ذلك، قد لا تحتوي بعض الميزات الخاصة بالتنسيق على مكافئات مباشرة، لذلك يمكن أن تحدث اختلافات بسيطة في التنسيق.
ما هو تنسيق HTML المستخدم؟
يتم استخدام HTML (لغة ترميز النص التشعبي) بشكل أساسي لصفحات الويب ومحتوى الويب.
هل هناك أي قيود يجب أن تكون على علم بها؟
يتم دعم الملفات التي يصل حجمها إلى 50 ميجابايت. قد تستغرق معالجة الملفات الكبيرة أو المعقدة وقتًا أطول. تتم جميع التحويلات في متصفحك، لذا تعتمد سرعة المعالجة على جهازك.
هل هذا التحويل آمن وخاص؟
نعم. تتم جميع عمليات المعالجة محليًا في متصفحك. لا تترك بياناتك جهازك أبدًا - لا يوجد تحميل على الخادم، ولا معالجة سحابية، ولا جمع بيانات.
هل الرموز التعبيرية مدعومة؟
تمر الرموز التعبيرية Unicode مباشرة (كتابة رمز تعبيري للقلب يظهر قلبًا في الإخراج). نمط GitHub :emoji: لا يتم تحويل الرموز القصيرة افتراضيًا؛ أضف امتدادًا إذا كنت بحاجة إلى ذلك.
هل تم تحميل تخفيض السعر الخاص بي على الخادم؟
لا، عمليات التشغيل المحددة في متصفحك؛ يحدث التحويل بالكامل على جهازك.
هل يمكنني إضافة نمط مخصص إلى HTML؟
نعم بعد التحويل الإخراج هو HTML الدلالي عادي؛ قم بتطبيق CSS الخاص بك على عناوين الأنماط وكتل التعليمات البرمجية والجداول والعناصر الأخرى.
هل يدعم الحواشي السفلية؟
لا يحدد CommonMark القياسي بناء جملة الحاشية السفلية. تدعم بعض امتدادات Markdown صيغة الحواشي السفلية [^1]؛ يتبع هذا المحول GFM، الذي لا يتضمن الحواشي السفلية.