يتيح Markdown للمطورين والكتّاب وتطبيقات الملاحظات إبقاء النص مقروءًا كنص عادي مع تمييز العناوين والقوائم والتأكيد. لكن معظم القراء لا يستطيعون فتحه منسقًا. تحوّل أداة تحويل Markdown إلى PDF الملف باستخدام Pandoc وتعرضه كمستند منسق، فيصبح ملف README أو ملف محاضر اجتماع أو جزء من التوثيق ملف PDF يستطيع أي شخص قراءته.
طريقة استخدام تحويل Markdown إلى PDF
- أضف ملف .md أو .markdown.
- اختر التحويل إلى PDF.
- نزّل ملف PDF.
- راجع الجداول وكتل الشيفرة والروابط في النتيجة.
ما الذي يُنسَّق
يفهم Pandoc صيغة Markdown الشائعة: العناوين والفقرات والخط العريض والمائل والقوائم المرقمة وغير المرقمة والاقتباسات والروابط والخطوط الأفقية وكتل الشيفرة المحددة والجداول ذات الخطوط العمودية. ويحوّلها إلى HTML يُنسَّق بعد ذلك على صفحات PDF، وتبقى الروابط قابلة للنقر في ملف PDF. لا تُصاغ الرموز الرياضية المكتوبة بلغة TeX كمعادلات، لذا تحتاج المستندات التي تعتمد كثيرًا على الرياضيات إلى أداة صف متخصصة.
الصور والخوادم التي لا تملك Pandoc
تحوّل الأداة ملف Markdown واحدًا، لذا لا تتوفر الصور المشار إليها بمسارات نسبية، وتُحظر الصور القادمة من عناوين الويب لأسباب أمنية. حوّل المخططات منفصلة بأداة تحويل الصور إلى PDF إذا احتجت إليها. ويعتمد التنسيق على تثبيت Pandoc على الخادم؛ وحيث لا يتوفر، ينتج VelloDoc ملف PDF مع ذلك لكنه يعرض Markdown كنص عادي برموزه الظاهرة.
سير عمل التوثيق
تناسب أداة تحويل Markdown إلى PDF مشاركة التوثيق مع أشخاص من خارج مستودع الشيفرة، مثل العملاء أو المدققين أو المديرين. اجمع عدة ملفات محوّلة في دليل واحد بأداة دمج ملفات PDF ورقّم الصفحات بأداة ترقيم صفحات PDF. وللملاحظات البسيطة دون بنية تكفي أداة تحويل TXT إلى PDF، وتستخرج أداة تحويل PDF إلى Markdown النص مجددًا. ويشرح دليل التنسيقات المزايا والعيوب.
متى تُستخدم أداة تحويل Markdown إلى PDF
ملفات README لغير المطورين
امنح العملاء أو المديرين ملف PDF مقروءًا لملف README الخاص بمشروع دون أن تطلب منهم تصفح مستودع.
محاضر الاجتماعات واليوميات
حوّل الملاحظات المحفوظة في تطبيقات Markdown إلى مستندات يمكنك حفظها أو طباعتها أو إرسالها كمحاضر.
التوثيق التقني
اجمع أدلة الإعداد وإجراءات التشغيل في ملفات PDF للتدقيق أو التسليم أو الرجوع إليها دون اتصال.
قيود ينبغي معرفتها
تحوّل أداة تحويل Markdown إلى PDF ملفًا واحدًا في كل مرة، لذا لا تُضمَّن الصور ذات المسارات النسبية وتُحظر الصور البعيدة. لا تُصاغ معادلات TeX. ويتطلب التنسيق الكامل وجود Pandoc على الخادم؛ ومن دونه يكون الناتج نصًا عاديًا. كما تتطلب الأداة WeasyPrint.
تحويل Markdown إلى PDF: أسئلة شائعة
ما صيغ Markdown المدعومة؟
العناوين والتأكيد والقوائم والاقتباسات والروابط وكتل الشيفرة المحددة والخطوط الأفقية والجداول ذات الخطوط العمودية كلها مدعومة عبر Pandoc.
لماذا صوري مفقودة؟
يُرفع ملف Markdown وحده، لذا لا يُعثر على الصور المشار إليها بمسارات نسبية، وتُحظر الصور البعيدة. حوّل الصور منفصلة وادمج ملفات PDF إذا لزم الأمر.
لماذا يعرض ملف PDF رموز Markdown الخام؟
لا يحتوي الخادم على Pandoc، لذا عُرض الملف كنص عادي. أما الخادم المزوّد بـ Pandoc فينتج مخرجات منسقة.
هل تُلوَّن صيغة الشيفرة؟
تحتفظ كتل الشيفرة بتخطيطها أحادي المسافة وفواصل أسطرها. ويعتمد التلوين على إصدار Pandoc في الخادم، لذا لا تعتمد عليه لفهم معنى الشيفرة.