محول Markdown إلى PDF

يقوم محول Markdown إلى PDF بتحويل نص مصدر Markdown إلى مستند PDF ثابت.

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

تعني عبارة "MD إلى PDF" الشيء نفسه. MD هو اختصار شائع لـ Markdown، و .md هو امتداد اسم الملف المستخدم بشكل شائع لمستندات Markdown.

ملف .md هو مستند Markdown نصي بسيط. يقبل SolConverter ملفات المصدر بصيغة .md و .txt ويحول محتوى Markdown المدعوم إلى PDF من خلال سير عمل عبر الإنترنت.

يعد هذا مفيدًا عندما تريد الاحتفاظ بـ Markdown كمصدر قابل للتعديل ولكنك تحتاج إلى مستند مستقر للعملاء أو الزملاء أو الطلاب أو المراجعين أو الأشخاص الذين لا يعملون مع Markdown.

تشمل الطرق الشائعة لوصف نفس المهمة ما يلي:

• Markdown إلى PDF
• MD إلى PDF
• ملف Markdown إلى PDF
• ملف .md إلى PDF
• تحويل Markdown إلى PDF
• تصدير Markdown كـ PDF
• حفظ Markdown كـ PDF

تتم معالجة جميع احتياجات التحويل هذه بواسطة هذه الصفحة.

يعرض SolConverter هياكل Markdown الشائعة الاستخدام في المستندات التقنية والعامة.

المحتوى المدعوم يشمل:

• عناوين ATX و Setext؛
• الفقرات، وفواصل الأسطر، والخطوط الأفقية؛
• النصوص العريضة والمائلة والمشطوبة؛
• القوائم المرتبة وغير المرتبة، بما في ذلك القوائم المتداخلة؛
• قوائم مهام GFM مع مربعات الاختيار؛
• الاقتباسات والاقتباسات المتداخلة؛
• التعليمات البرمجية المضمنة والكتل البرمجية المسيجة؛
• روابط Markdown، والروابط التلقائية للويب والبريد الإلكتروني؛
• جداول GFM مع محاذاة لليسار والوسط واليمين؛
• جداول HTML الخام الآمنة مع التحكم في rowspan و colspan؛
• عناصر المستند مثل details، و summary، و kbd، و sub، و sup، و figure، و figcaption؛
• روابط العناوين؛
• بيانات YAML الفوقية (front matter) في بداية الملف، والتي تُعامل كبيانات وصفية بدلاً من محتوى مطبوع.

يتم عزل كتل التعليمات البرمجية أو المحددات التالفة محليًا حيثما أمكن ذلك، بحيث لا تؤثر مشكلة التنسيق على بقية المستند.

يقوم SolConverter بمعالجة صيغ LaTeX و MathML المدعومة كرسومات MathJax SVG. يظل مخرج SVG حادًا وواضحًا عند تكبير ملف PDF أو طباعته.

تتعرف معالجة الرياضيات على التعبيرات قبل تحليل Markdown، مما يساعد على حماية الشرطات السفلية والعلامات النجمية ومحددات العرض وبيئات المعادلات من التغيير بواسطة محلل Markdown.

يتضمن إدخال الرياضيات المدعوم ما يلي:

• الرياضيات المضمنة باستخدام $...$ و \(...\)؛
• الرياضيات المعروضة باستخدام $$...$$ و \[...\]؛
• بيئات AMS الشائعة مثل equation و align و gather و multline و split و cases؛
• الكسور والجذور والقوى والمؤشرات والمجاميع والضرويات والتكاملات والنهايات والمتسلسلات؛
• المصفوفات والمحددات والمصفوفات والرموز الموترة (tensor)؛
• رموز التفاضل والتكامل، والمعادلات التفاضلية، والجبر الخطي، والاحتمالات، والإحصاء، والفيزياء، والكيمياء؛
• عمليات Presentation MathML و Content MathML الأساسية؛
• تعبيرات الكيمياء المكتوبة باستخدام \ce{...}؛
• وحدات الماكرو المحددة على مستوى المستند مثل \newcommand و \DeclareMathOperator.

يمكن تقسيم التعبيرات الإضافية الطويلة عند المشغلات عالية المستوى بدلاً من قصها عند حافة الصفحة أو تقليل حجمها حتى تصبح صعبة القراءة. يتم الاحتفاظ بمعادلات العرض معًا عندما يتمكن المتصفح من احتواء الكتلة في الصفحة.

يقوم SolConverter بعزل الرياضيات التالفة في الموقع الذي تحدث فيه المشكلة.

عندما لا يمكن عرض كتلة LaTeX أو MathML بأمان، يمكن للمحول الحفاظ على مصدر احتياطي محايد ومتابعة عرض المحتوى الصالح الذي يليه. يتم استخدام نفس نهج الفشل المحلي للرسوم البيانية والصور.

هذا الأمر مهم للمستندات التقنية الطويلة. لا ينبغي لمعادلة تالفة واحدة، أو صورة غير متاحة، أو مخطط غير صالح أن يؤدي تلقائيًا إلى تجاهل كل صفحة صالحة حوله.

يتم عرض كتل Mermaid المسيجة المدعومة كـ SVG داخل ملف PDF. يتم دعم ZenUML من خلال تكامل مخطط Mermaid الخارجي المدمج محليًا.

يتم عرض كل مخطط صالح بشكل مستقل وتقييده بعرض الصفحة المتاح. إذا فشل مخطط ما، يقوم SolConverter بإدراج تراجع محلي مع المصدر ويستمر في معالجة المستند المتبقي.

محركات المخططات المدعومة حاليًا هي Mermaid و ZenUML. لا يتم دعم PlantUML و Graphviz و D2 و WaveDrom و BPMN و Nomnoml و TikZ الكامل حاليًا.

غالبًا ما تمزج المستندات التقنية بين الشرح والأوامر والتكوين والتعليمات البرمجية المصدرية. يستخدم SolConverter أداة Highlight.js لتطبيق إبراز الصيغة عند التعرف على لغة كتل التعليمات البرمجية.

يتضمن مخرج الكود ما يلي:

• خط أحادي المسافة (monospace) مخصص؛
• خلفية وحدود وحشو مرئي للكتل المسيجة؛
• اكتشاف اللغة من سلسلة معلومات كتل التعليمات البرمجية؛
• مخرج مصدر آمن عند عدم التعرف على اللغة؛
• الحماية من تفسير محددات الرياضيات داخل الكود؛
• عزل من اليسار إلى اليمين للكود داخل المستندات التي تكتب من اليمين إلى اليسار.

وبالتالي يحتفظ ملف PDF بالتعليمات البرمجية منفصلة بصريًا عن النص المحيط مع الحفاظ على المصدر الأصلي.

يكتشف SolConverter اتجاه المستند من المحتوى ويدعم ملفات PDF متعددة اللغات مع توفير بدائل الخطوط المناسبة.

تشمل سيناريوهات النصوص المدعومة ما يلي:

• الأحرف الفيتنامية واللاتينية الموسعة؛
• تخطيط اللغة العربية والعبرية؛
• النصوص الصينية واليابانية والكورية؛
• النصوص الهندية والبرهمية؛
• السيريلية واليونانية؛
• المستندات ذات النصوص المختلطة؛
• علامات التشكيل والدمج؛
• العديد من رموز Unicode والرموز التعبيرية، اعتمادًا على تغطية الخطوط المتاحة.

تظل الرياضيات والرموز البرمجية من اليسار إلى اليمين حتى عندما يكون اتجاه المستند الرئيسي من اليمين إلى اليسار.

يدعم SolConverter صور HTTP و HTTPS العامة بالإضافة إلى صور بيانات base64 الصالحة بتنسيقات PNG و GIF و JPEG و WebP و SVG.

يتم تقييد الصور بعرض الصفحة مع الحفاظ على نسبة العرض إلى الارتفاع الخاصة بها. تتضمن بيانات الصور الوصفية المدعومة النص البديل (alt text)، والعنوان، والأبعاد الآمنة، والمحاذاة، والأشكال، والتسميات التوضيحية.

يتم استبدال الصورة غير المتاحة أو غير الصالحة بنائب محلي يحتوي على نصها البديل. ثم يستمر المحول في معالجة بقية مستند Markdown بدلاً من إفشال ملف PDF بأكمله.

لدواعي الأمان، يتم حظر المسارات المحلية، وعناوين المضيف المحلي (localhost)، وعناوين IP الخاصة، وعناوين URL التي تبدأ بـ javascript:، والمخططات غير المدعومة. لا يتم تجميع مجلدات الأصول النسبية للمستودع تلقائيًا مع ملف Markdown المرفوع.

يطبق المحول تخطيط PDF متسقًا للمستندات التقنية والملاحظات والتقارير ومخرجات الطباعة.

يستخدم نموذج الويب الحالي:

• حجم الصفحة A4؛
• الاتجاه الرأسي؛
• هوامش مدارة لإنتاج مخرجات مقروءة؛
• ترقيم الصفحات بتنسيق current / total؛
• عنوان مخرج يعتمد على اسم ملف المصدر؛
• الخلفيات المطبوعة.

يطبق نظام العرض أيضًا حماية أساسية لتخطيط الطباعة. فهو يحاول تجنب ترك العناوين بمفردها في أسفل الصفحة، ويقلل من الأسطر المعلقة والمنفصلة (widows and orphans) في الكتل النصية، ويكرر رؤوس الجداول عندما يدعم المتصفح ذلك، ويتجنب تقسيم الكتل البرمجية، وصفوف الجداول، والأشكال، والصور، والمخططات، ومعادلات العرض عندما تتوفر مساحة كافية في الصفحة.

من السهل تصدير مستندات Markdown البسيطة. بينما يصعب تصدير مستندات Markdown التقنية الطويلة لأن الرياضيات والمخططات والجداول والرموز البرمجية والنصوص متعددة اللغات والصور الخارجية وترقيم الصفحات تتفاعل كلها معًا.

تم تصميم SolConverter حول هذه الحالة الأكثر تطلبًا. تتضمن معالجة تحويل Markdown إلى PDF عرض MathJax SVG، ومخططات Mermaid و ZenUML، وإبراز الصيغة البرمجية، ودعم Unicode ولغات RTL، والتطهير (sanitization)، وضوابط الشبكة، وعزل الفشل على مستوى الكتلة، ومتابعة تقدم المهمة، ونتائج منفصلة للمعاينة والتنزيل.

في اختبار الضغط الداخلي الذي تم إجراؤه في 4 أغسطس 2026، أنتج المعالج ملف PDF مكونًا من 156 صفحة من ملف يحتوي على 92 قسمًا و 333 تعبيرًا من تعبيرات MathJax. تضمن الاختبار أيضًا لغة MathML تالفة عمدًا وتعبيرًا طويلاً مكونًا من 84 حدًا للتحقق من معالجة الأخطاء المحلية وفصل الأسطر. هذه شروط اختبار داخلية، وليست وعدًا بأن كل مستند سينتج نفس النتيجة.

يمكن أن تحتوي ملفات Markdown المرفوعة على تعليمات HTML خام، وعناوين URL للصور، ومحتويات أخرى لا ينبغي الوثوق بها تلقائيًا.

يقوم SolConverter بتطهير الـ HTML المعروض باستخدام قائمة مسموحات (allowlist)، ويزيل النصوص البرمجية ومعالجات الأحداث، ويرفض عناوين URL غير الآمنة، ويقيد امتدادات الجداول، ويطبق سياسة أمان محتوى مقيدة، ويعترض طلبات المتصفح التي تخرج عن سياسة الصور.

يمكن عرض صور البيانات الصالحة دون طلب شبكة. يُسمح بالصور البعيدة العامة من خلال سياسة الصور، بينما يتم حظر الوجهات المحلية والخاصة وغير المدعومة.

تنتهي صلاحية التحميلات الجديدة بعد 15 دقيقة إذا لم يبدأ التحويل. بعد التحويل الناجح، يتم حذف المصدر بمجرد التحقق من المخرج؛ وتنتهي صلاحية المدخلات الفاشلة مع نافذة الـ 15 دقيقة الأصلية. تظل ملفات PDF المكتملة متاحة لمدة تصل إلى ساعتين. راجع سياسة الخصوصية لمعرفة دورة الحياة الكاملة.

تعد لغة Markdown فعالة للكتابة والتحكم في الإصدارات. وتكون صيغة PDF مفيدة عندما يحتاج المستند إلى مظهر ثابت وتنسيق تسليم مدعوم على نطاق واسع.

قد ترغب في تحويل Markdown إلى PDF عندما تحتاج إلى:

• إرسال مستندات تقنية خارج مستودع المصدر؛
• تسليم تقرير أو مواصفات أو مقترح أو دليل تشغيل ثابت؛
• إنشاء ملاحظات دراسية قابلة للطباعة أو مواد تدريبية؛
• توزيع ملف README أو سجل تغييرات إلى القراء غير التقنيين؛
• مراجعة المعادلات والمخططات في تنسيق يعتمد على الصفحات؛
• أرشفة نسخة محددة من مستند متغير؛
• مشاركة المستندات دون الحاجة إلى محرر Markdown؛
• الحفاظ على مصدر Markdown قابل للتعديل وإنشاء ملف تسليم منفصل.

يكون محول Markdown إلى PDF عبر الإنترنت هو الأفضل عندما تريد تحميلًا مباشرًا وعرضًا مدارًا ومعاينة وسير عمل تنزيل دون تكوين أدوات محلية.

قد تكون الأداة المحلية مثل Pandoc أو امتداد المحرر خيارًا أفضل عندما تحتاج إلى تحويل دون اتصال بالإنترنت، أو قوالب مخصصة، أو أنماط CSS عشوائية، أو معالجة الاستشهادات، أو خط معالجة برمجي، أو تحويل دفعي داخل مستودع.

يركز SolConverter على عرض Markdown إلى PDF المدار للمستندات الفردية المرفوعة. لا يوفر حاليًا دعمًا كاملاً للاستشهادات من Pandoc، أو CSS عشوائي للمستخدم، أو إشارات مرجعية تلقائية لملف PDF، أو مجلدات أصول نسبية معبأة، أو كل لغات المخططات.

المستندات التقنية

قم بتحويل ملاحظات الهندسة المعمارية، وشروحات واجهة برمجة التطبيقات (API)، وأدلة التشغيل، ومستندات الإصدارات، والمواصفات، والأدلة الداخلية إلى ملف PDF مستقر.

المستندات الرياضية والعلمية

قم بعرض صيغ LaTeX و MathML والمصفوفات والمعادلات ورموز الكيمياء والتعبيرات الطويلة كرياضيات تعتمد على SVG داخل ملف PDF.

مستندات المطورين

احتفظ بكتل الكود، والرموز البرمجية المضمنة، والجداول، وقوائم المهام، والمخططات، والشروحات الهيكلية معًا في مستند يمكن مراجعته خارج المستودع.

التقارير متعددة اللغات

قم بإنشاء ملفات PDF تحتوي على نصوص فيتنامية، وصينية ويابانية وكورية (CJK)، وعربية، وعبرية، وسيريلية، ويونانية، وهندية، ومحتوى مختلط من اليسار إلى اليمين ومن اليمين إلى اليسار.

الملاحظات والتقارير والمقترحات

اكتب بلغة Markdown، ثم أنشئ مستندًا ثابتًا للطباعة أو الموافقة أو المشاركة أو الأرشفة.

استخدم أداة أخرى من SolConverter عندما يكون التنسيق المصدر أو المخرج المطلوب مختلفًا.

• تحويل الملفات إلى Markdown
• تحويل PDF إلى Markdown
• تحويل Word إلى Markdown
• تحويل HTML إلى Markdown
• تحويل Excel إلى Markdown
• تحويل CSV إلى Markdown
• تصفح محولات البيانات
• تحويل JSON إلى CSV
• تحويل CSV إلى JSON
• اقرأ الدليل التقني لتحويل Markdown إلى PDF