حوّل ملفات Markdown إلى PDF دون فقدان المستند
تم تصميم Markdown ليُقرأ على شاشة قابلة للتمرير، بينما يتكوّن PDF من صفحات ذات حدود واضحة. معظم المحوّلات تتجاهل هذا الفرق: فهي ترسل الملف إلى المتصفح، تضغط على الطباعة، ثم تعيد ما ينتج عن ذلك. لهذا السبب غالبًا ما تضيع الأعمدة الأخيرة من الجداول، أو ينتهي الأمر بعنوان في أسفل الصفحة، أو يظهر شعار README كسطر من HTML الخام مطبوع كنص. أما هنا، فيتم ترتيب المستند ليتناسب مع الورق أولاً، ثم يتم إعلامك بما تم فعله للوصول إلى هذه النتيجة.
جداول تناسب الورق دائمًا
لا تحتوي جداول Markdown على عرض أعمدة محدد. لا توجد طريقة لتحديدها في الصياغة، لذا فإن المحوّل الذي يرسل الجدول مباشرة إلى المتصفح يأمل فقط أن يتناسب مع الصفحة. هنا، يتم قياس كل جدول قبل رسمه وتعديله ليتناسب مع الورق الذي اخترته. حتى جدول مسارات الملفات ذو أربعة عشر عمودًا يبقى داخل الهوامش، وتلتف القيم الطويلة بدلاً من أن تخرج عن الحافة، ويتم الإشارة إلى ذلك في النتيجة.
أما الجزء الأقل وضوحًا من المشكلة فيحدث في الصفحة الثانية. غالبًا ما تترك الجداول الطويلة صف الرأس في الصفحة الأولى، فيحصل القارئ على شبكة من الأرقام غير المسمّاة. هنا، يتكرر صف الرأس في كل صفحة يصل إليها الجدول، ولا يتم قطع أي صف إلى نصفين بسبب فاصل صفحة.
كود يبقى داخل الهوامش
يحافظ الكود المحاط بأسوار على تمييزه اللوني واسم اللغة. تلتف الأسطر الطويلة بحيث يمكنك رؤية أنها التفت، بدلاً من أن تُقص عند نهاية الورقة. لا يوجد شريط تمرير في PDF، لذا فإن السطر الذي لا يلتف سيُفقد جانبه الأيمن. الكتل المزاحة، والأسوار بدون لغة، والكود المضمّن، كلها تظهر كما هي.
الصور في README الخاص بك
نادراً ما تتم كتابة الشعار وصف شارات البناء في Markdown. لا توجد طريقة لمحاذاة صورة في المنتصف، لذا غالبًا ما تلجأ ملفات README إلى HTML الخام. المحوّل الذي يرفض عرض HTML عادةً ما يهربها بدلاً من تجاهلها، مما يعني أن المستند يبدأ بمجموعة من وسوم الصور مطبوعة كنص. هنا، يتم إزالة العلامات مع الاحتفاظ بالصور والكلمات بداخلها، ليبدو أعلى المستند كما هو متوقع.
يتم جلب الصور ودمجها داخل الملف بدلاً من ربطها، لذا سيعمل PDF دون اتصال وسيظل يعمل بعد عام. إذا تعذّر جلب صورة ما، يتم عدّها والإشارة إلى ذلك في النتيجة بدلاً من ترك فراغ مكان الصورة بصمت.
عناوينك تتحول إلى فهرس للتنقل
يحمل كل PDF شجرة إشارات مرجعية مبنية من عناوينك، بحيث يمكن التنقل في المستند الطويل من الشريط الجانبي بدلاً من التمرير. إذا طلبت صفحة محتويات، ستحصل على صفحة قابلة للنقر، وبالعمق الذي تختاره من العناوين. يُقرأ العنوان الوحيد في الأعلى كعنوان المستند ويُستثنى من القائمة، كما هو الحال في الكتب وليس الفصول.
تظل الحواشي السفلية حواشي، مع علامة مرتفعة ورابط يعيدك إلى السطر الذي كنت تقرأه. قوائم المهام تحتفظ بمربعاتها، سواء كانت محددة أم لا. ملاحظات التنبيه والتحذير والنصائح تحتفظ بشريط اللون الخاص بها. يتم التعامل مع بيانات التعريف في أعلى الملف كبيانات وصفية وتبقى خارج الصفحة. قوائم التعريف، الشطب، الاقتباسات المتداخلة حتى ثلاث مستويات، والقوائم المتداخلة كلها تظهر كما هي.
يخبرك بما لم يستطع فعله
كل عملية تحويل تأتي مع ملخص قصير: عدد الصفحات، اتجاه النص، عدد الجداول، عدد كتل الكود، عدد الصور المدمجة وعدد الصور التي تعذّر جلبها. إذا كان هناك رمز مفقود في الخط، يتم ذكره. إذا طلبت صفحة محتويات ولم يكن هناك عناوين لإدراجها، سيتم إبلاغك بذلك بدلاً من تسليمك ملفًا بصفحة فارغة في المقدمة. المحوّل الذي يخفي إخفاقاته هو السبب في فقدان الثقة في المحوّلات.
النصوص غير اللاتينية
يتم تضمين الخطوط داخل PDF، لذا يفتح المستند بنفس الشكل على أي جهاز حتى لو لم يكن يحتوي على الخطوط. يُحدد اتجاه النص من اليمين إلى اليسار لكل كتلة على حدة وليس مرة واحدة للملف كله، وهذا مهم لأن المستندات التقنية في هذه اللغات غالبًا ما تحتوي على الكثير من النص اللاتيني، مثل مسارات الملفات وأسماء الأصناف، ومع ذلك تظل تُقرأ من اليمين إلى اليسار. يتم استثناء الكود المحاط بأسوار من هذا القرار ويُعرض دائمًا من اليسار إلى اليمين، بينما ينعكس باقي التخطيط بشكل صحيح: النقاط، أشرطة الاقتباس، وأعمدة الجداول كلها تتحرك. وإذا لم يكن للخط نمط مائل، يتم تمييز التأكيد بزيادة الوزن بدلاً من إمالة الحروف.
ما الذي لن يفعله
لا يتم عرض LaTeX. يظهر أي كتلة بين علامات الدولار كنص كما هو. ولا يتم رسم Mermaid أيضًا: يظهر السور المسمى mermaid ككتلة كود معنونة وليس كرسم بياني. أما الصينية واليابانية والكورية فهي خارج الخطوط المتوفرة في الأداة، لذا يتم الإبلاغ عن الرموز المفقودة بدلاً من تخمينها. هذه حدود وليست عيوبًا، وتم ذكرها هنا حتى لا يكتشفها أحد بعد الرفع.
الجانب العملي
يمكنك الرفع من جهازك، أو من Google Drive، أو بلصق رابط إلى ملف. تُقبل ملفات Markdown بجميع امتداداتها المعتادة، وكذلك النص العادي. الورق يمكن أن يكون A3 أو A4 أو A5 أو Letter أو Legal أو Tabloid، بالطول أو العرض، مع هوامش ضيقة أو عادية أو واسعة. أرقام الصفحات وتمييز الصياغة مفعّلان ما لم تقم بإيقافهما. أرسل ملفًا واحدًا وسيعود إليك PDF؛ أرسل عدة ملفات وستحصل عليها في ملف ZIP، أو كملف PDF واحد مدمج مع ترقيم صفحات متواصل إذا طلبت ذلك. يظل النص نصًا حقيقيًا، بحيث يمكن تحديده والبحث فيه ونسخه، بدلاً من تحويله إلى صورة للكلمات.
ماذا ستحصل عليه
- جداول تبقى داخل الهوامش، مع تكرار صف الرأس في كل صفحة تصل إليها
- كود مميز بالألوان مع التفاف للأسطر الطويلة بدلاً من قصها
- صور مدمجة داخل الملف، بما في ذلك تلك المكتوبة بـ HTML الخام
- شجرة إشارات مرجعية من عناوينك، وصفحة محتويات قابلة للنقر عند الحاجة
- خطوط مدمجة داخل PDF، ليبدو الملف نفسه على أي جهاز يفتحه
- ملخص مكتوب بكل ما لم يستطع المحوّل فعله، بما في ذلك الرموز والصور المفقودة
ما الخطوة التالية؟
تعمل من ملف Word بدلاً من ذلك؟ تحويل Word إلى PDF يسلك نفس الطريق إلى الورق.
اجمع النتيجة مع بقية التقرير باستخدام دمج PDF.
ثم قلل حجم الملف قبل إرساله عبر ضغط PDF.