كيفية تحويل Markdown إلى PDF (مجاناً، بكتل شفرة وجداول سليمة)

‏Markdown هو حيث تُكتب الأشياء — ملفات README وملاحظات الاجتماعات والمواصفات والتوثيق. وPDF هو حيث تُرسَل: إلى عميل لن يفتح ملف .md، إلى مدير يريد مرفقاً، إلى طابعة. الفجوة بين الاثنين تحويل واحد، ولا ينبغي أن تحتاج إلى تثبيت pandoc وتوزيعة LaTeX لعبورها.

مشكلة معظم المسارات السريعة أنها تشوّه بالضبط الأجزاء التي تعتمد عليها المستندات التقنية: تنهار كتل الشفرة إلى حرف متناسب، وتُطبَع جداول الأنابيب جداراً من محارف |، وتتسطّح القوائم المتداخلة. لا يكون المحوّل مفيداً هنا إلا إذا نجت الشفرة والجداول — وهذا هو المعيار الذي يُخضع له هذا الدليل كل شيء.

كيفية التحويل — خطوة بخطوة

🔒 pdfty.com/en/tools/markdown-to-pdf

ما الذي يُعرَض بالضبط

يدعم المحوّل Markdown القياسي مع الامتدادات المهمة للكتابة التقنية:

• العناوين — هرمية الأحجام، بخطوط خفيفة تحت H1 وH2
• كتل الشفرة المسيَّجة — أحادية المسافة، خلفية رمادية فاتحة، إزاحة محفوظة، تظليل صياغي للغات الشائعة
• الشفرة الداخلية — تنسيق الرقاقة الرمادية المألوف
• الجداول — جداول الأنابيب على طريقة GitHub تصبح جداول بحدود وصف ترويسة مظلَّل
• الاقتباسات — حد جانبي، نص باهت
• القوائم — مرتبة وغير مرتبة ومتداخلة
• الروابط — تبقى روابط قابلة للنقر في ملف PDF
• الصور بعناوين URL — صور ![](https://…) تُجلَب وتُضمَّن

تُنضَّد الصفحة بعرض قراءة مريح وهوامش سخية — أقرب إلى «مستند داخلي يبدو منتهياً» منها إلى مطبوعة متصفح خام.

ما الذي لا يُعرَض

قسم الصراحة. لـ Markdown لهجات، وهذه الأداة تنفّذ Markdown القياسي + الجداول + الشفرة المسيَّجة، لا نكهة GitHub الكاملة:

• قوائم المهام (- [ ] todo) تُطبَع أقواساً حرفية، لا مربعات تأشير.
• الشطب (~~text~~) لا يُحوَّل — تبقى علامات التلدة.
• الصور المحلية (![](./diagrams/arch.png)) لا يمكن أن تظهر: ترفع ملفاً واحداً، ولا وصول للخادم إلى الملفات المجاورة له على قرصك. استضف الصورة على عنوان URL أو توقّع فجوة.
• كتل Mermaid / الرياضيات تُعرَض كتل شفرة عادية، لا مخططات أو معادلات.
• لا سمات مخصصة — ورقة أنماط مدمجة واحدة، دون رفع CSS.

بدائل محلية مجانية

pandoc — المحوّل القانوني: ‏pandoc README.md -o readme.pdf. مخرجات رائعة وقابلية ضبط بلا حدود، لكن مخرجات PDF تتطلب محرك LaTeX (تثبيت 1–4 غيغابايت غالباً). يستحق إن كنت تحوّل المستندات أسبوعياً؛ سخيف لملف README واحد.

امتدادات VS Code (مثل «Markdown PDF») — مريحة إن كنت تعيش في VS Code أصلاً؛ تتفاوت جودة المخرجات حسب الامتداد والسمة.

معاينة المتصفح + الطباعة: اعرض Markdown في أي مكان يعاينه (كثير من المحرّرات تقدم معاينة HTML)، ثم Ctrl/Cmd+P ← حفظ كـ PDF. مجاني ومحلي، لكنك ترث غرائب طباعة المتصفح: ترويسات/تذييلات URL ما لم تعطّلها، وفواصل صفحات تهبط وسط كتل الشفرة.

macOS: لا عارض Markdown مدمجاً — تعامل «معاينة» وTextEdit ملف .md نصاً عادياً، فسترى العلامات والنجوم الخام.

ملاحظات عملية

• فواصل الصفحات تلقائية. قد تنقسم كتل الشفرة الطويلة عبر الصفحات. لا علامة فاصل صفحات يدوياً؛ يكسر المحرك حيث يلزم.
• الجداول العريضة جداً وأسطر الشفرة الطويلة تُحجَّم أو تُقتطَع عند عرض المحتوى — صف جدول من 200 محرف لا يتسع في صفحة عمودية برشاقة. قصّر الأسطر حيث استطعت.
• المادة الأمامية (كتلة YAML بين --- أعلى الملف) تُعامَل محتوى، لا تُخفى — احذفها قبل التحويل إن لم ترد طباعتها. (وقد تُعرَض كتلة --- في أول الملف أيضاً خطاً أفقياً مع نص، حسب التنسيق.)
• رموز الإيموجي المختصرة مثل :rocket: تبقى حرفية؛ أما محارف الإيموجي الملصوقة الحقيقية فتُعرَض عموماً.
• افحص أهداف الروابط. الروابط النسبية ([docs](./docs/setup.md)) تنجو كروابط لكنها تشير إلى لا مكان مفيد حال الطباعة.

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

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

هل تحتفظ كتل الشفرة بالتظليل الصياغي؟

نعم — الكتل المسيَّجة بتلميح لغة (```python) تحصل على تظليل ملون؛ ودون تلميح تكون أحادية المسافة عادية على رمادي. في الحالتين تُحفَظ الإزاحة بدقة.

هل تُعرَض الجداول جداول فعلاً؟

نعم — جداول الأنابيب (أسلوب GitHub) تصبح جداول بحدود وصف ترويسة مظلَّل. ويحترم المحلّل نقطتَي المحاذاة.

لماذا صورتي مفقودة من ملف PDF؟

لأنها مُشار إليها بمسار محلي. المرفوع ملف .md واحد، فيشير ./images/x.png إلى لا شيء. استخدم عنوان https:// كاملاً، أو حوّل محلياً بـ pandoc حيث تُحَل المسارات النسبية.

هل يمكنني تحويل README مباشرة من GitHub؟

نزّل ملف .md الخام أولاً، ثم ارفعه. الشارات والصور المستضافة بعناوين URL كاملة تمرّ عادةً؛ أما ميزات GitHub الحصرية (قوائم المهام وmermaid) فلا — انظر القائمة أعلاه.

هل يمكنني تغيير الخطوط أو الهوامش أو الألوان؟

ليس في هذه الأداة — تأتي بورقة أنماط واحدة نظيفة عمداً. لتصميم بهوية بصرية، مرّ عبر HTML إلى PDF بـ CSS خاص بك.

هل هناك حد حجم أو صفحات؟

مجاناً: 20 ميغابايت لكل ملف و10 عمليات يومياً — للملفات النصية هذا عملياً بلا حد. وملفات PDF الناتجة التي تتجاوز 50 صفحة تتولّد دون مشاكل من مصدر Markdown واحد.

هل مستندي خاص؟

النقل عبر HTTPS وتُحذَف الملفات تلقائياً خلال ساعة. وللمواد السرية التي لا يمكنك رفعها، pandoc هو المسار المحلي.

هل يمكنني الاتجاه المعاكس — من PDF إلى Markdown؟

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