تحويل Markdown إلى PDF

أي Markdown، وما الذي يصبح عليه

Markdown عائلة لا مواصفة واحدة. النواة المشتركة — العناوين، والتأكيد، والقوائم، والروابط، والصور، والاقتباسات الكتلية، وكتل الكود — واحدة في كل مكان، وما بعدها يختلف من تطبيق إلى آخر. والمدعوم هنا هو المجموعة الموسّعة المتفق عليها على نطاق واسع: الجداول، وكتل الكود المسوّرة مع تلوين الصياغة، وقوائم المهام، والنص المشطوب، والحواشي، وfront matter. وهذا يغطي ما يكتبه الجميع تقريبًا، ومعرفة الحدود مسبقًا أفضل من اكتشافها.

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

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

شيئان يُعرضان ككود عمدًا بدلًا من رسمهما. المعادلات الرياضية بصياغة LaTeX ومخططات Mermaid يحتاج كلٌّ منهما إلى محرّك عرض خاص، ورسمهما بشكل خاطئ أسوأ من عرض المصدر — فالمعادلة المرسومة خطأً خاطئة بطريقة لا يستطيع أحد رؤيتها. وHTML الخام داخل Markdown يُعالَج للتنسيق البسيط داخل السطر لا للتخطيط، لأن كتلة ترميز عشوائية لا مكان لها في مستند مقسّم إلى صفحات.

عندما تحتاج إلى شيء آخر

Pandoc هو الأداة الجادة لهذه المهمة، وهو مجاني. pandoc doc.md -o doc.pdf --pdf-engine=xelatex ينسّق عبر LaTeX، فينتج مخرجات جميلة حقًا مع تقسيم صحيح للكلمات، والتحكم في الأسطر اليتيمة، وجدول محتويات حقيقي — ومع قالب تتحكم في كل جانب من جوانب التصميم. ويعرض أيضًا معادلات LaTeX بشكل صحيح، وهي تحديدًا الثغرة هنا. والثمن هو تثبيت توزيعة TeX، وهي ليست صغيرة.

للوثائق التقنية بدلًا من مستند لمرة واحدة، يُنتج مولّد المواقع الثابتة أو mdBook شيئًا أفضل من PDF: قابلًا للبحث والربط والقراءة على الهاتف. حوّل إلى PDF حين يجب طباعة المستند أو إرفاقه أو أرشفته — واحتفظ بملف Markdown مصدرًا مرجعيًا في كل الأحوال، لأنه النسخة التي يمكن تعديلها ومقارنة تغييراتها.