Markdown إلى PDF
الصق Markdown أو أفلِت ملف .md. متوافق مع Markdown بنكهة GitHub. 100% داخل متصفحك: لا يُرفع أي شيء.
أفلِت ملف .md أو .markdown
أو انقر لاختيار واحد — يُقرأ داخل متصفحك فقط
مثالي لملفات README التقنية والملاحظات. تُسطّح الجداول وتُسقَط الصور الخارجية لأجل الخصوصية.
Your file is ready
Processed entirely in your browser — the file never left your device.
كيفية تحويل Markdown إلى PDF
ثلاث خطوات. كل شيء يجري داخل متصفحك.
الصق أو أفلِت
الصق markdown في مربع النص أو أفلِت ملف .md. تُظهر المعاينة الحيّة كيف سيبدو الناتج.
اختر الخيارات
حجم الصفحة والاتجاه وحجم خط المتن ونمط كتل الشيفرة. تعمل القيم الافتراضية مع معظم ملفات README.
أنشئ ونزّل
يحلّل marked إلى HTML، ويُجزّأ HTML إلى كتل، ويُخطّطها pdf-lib — كل ذلك داخل علامة تبويبك.
لماذا تستخدم Markdown إلى PDF في imisspdf؟
يبقى المصدر على جهازك
غالبًا ما يحتوي markdown على ملاحظات داخلية أو مسودّات منشورات أو مفاتيح API في كتل الشيفرة. لا يُرفع أي شيء — كل بايت في العملية يجري محليًا.
سريع للمستندات التقنية
تُعرض العناوين والقوائم والشيفرة المُسيّجة بنظافة من النظرة الأولى. بلا مربع حوار طباعة، بلا التقاط من Chrome — الصق، انقر، ونزّل.
متوافق مع GFM
الشطب وقوائم المهام وكتل الشيفرة المُسيّجة والروابط التلقائية — المحلّل هو marked في وضع GFM. تُسطّح الجداول (نقولها مسبقًا).
ما معنى "Markdown إلى PDF" هنا
Markdown هو الصيغة التي يكتب بها معظم المطوّرين وكتّاب التوثيق التقني فعليًا — ملفات README، ومسودّات المدوّنات، وأدلّة التشغيل، وتوثيق API، والويكيات الداخلية. إنه خفيف، وقابل للإصدار، ويُعرض بنظافة على GitHub. لكن حين يحين وقت مشاركة ذلك المستند مع شخص لا يعمل في مستودعك، يكون ملف PDF عادةً صيغة التسليم المناسبة: يُطبع على نحو متوقّع، ويُفتح على أي جهاز، ولا يعتمد على امتلاك المستلم لعارض markdown مثبّت.
تأخذ أداة Markdown إلى PDF من imisspdf مصدر markdown الذي تلصقه (أو تفلته كملف .md) وتنتج ملف PDF واحدًا داخل متصفحك. تحافظ العناوين على تسلسلها الهرمي، وتحفظ القوائم مسافاتها البادئة، وتُعرض كتل الشيفرة المُسيّجة بخط أحادي المسافة، وتبدو الاقتباسات / الفواصل الأفقية كاقتباسات وفواصل. الناتج ملف PDF نظيف بلا زخرفة، مناسب لملف README أو تقرير تقني أو سجلّ تغييرات يُسلَّم لقارئ غير تقني.
كيف يعمل التحويل
ثلاث مراحل تجري من البداية إلى النهاية داخل علامة تبويبك:
- يحوّل المحلّل marked markdown إلى HTML مع تفعيل قواعد GFM (الشيفرة المُسيّجة، والشطب، وقوائم المهام، والروابط التلقائية).
- يمرّ مُجزّئ صغير قائم على التعبيرات النمطية على HTML ويحوّله إلى سلسلة مسطّحة من رموز الكتل — عناوين، وفقرات، وقوائم، وكتل شيفرة، واقتباسات — ونطاقاتها المضمّنة (غامق، ومائل، وشيفرة مضمّنة، وروابط).
- يخطّط pdf-lib الكتل على الصفحات باستخدام الخطوط الأربعة عشر القياسية في PDF (Helvetica للمتن، وCourier للشيفرة). تُضاف صفحات جديدة كلما فاض المحتوى.
لا شيء في هذه العملية يتحدّث إلى خادم. لا markdown يُعرض عن بُعد، ولا Chromium بلا واجهة يُشغَّل في دالة سحابية، ولا ملف مؤقت يُحتفظ به "لمدة ساعة امتثالًا لسياسة الاحتفاظ". يُبنى ملف PDF ببايتات JavaScript يمكنك مشاهدتها وهي تُكتب في أدوات المطوّر لديك.
متى تكون الأداة المناسبة — ومتى لا تكون
تكون هذه الأداة مناسبة حين تحتاج إلى ملف PDF نظيف وقابل للأرشفة من محتوى تقني: ملف README، أو دليل تشغيل، أو تقرير مكتوب بـ markdown، أو ملاحظات اجتماع، أو درس تعليمي. تتعامل مع التنسيق المضمّن والقوائم والشيفرة والاقتباسات كما تتوقّع لهذا النوع من المستندات.
وتكون الأداة الخطأ حين تحتاج إلى دقة بكسلية مطابقة لموقع معروض (استخدم خيار "حفظ كـ PDF" في متصفحك على الصفحة المعروضة)، أو حين تحتاج إلى جداول بجودة طباعية (استخدم Pandoc + LaTeX محليًا)، أو حين تحتاج إلى شيفرة بإبراز بناء الجملة (صدّر من محرّرك كـ HTML واستخدم HTML إلى PDF). نسمّي الحدود مسبقًا كي تختار سير العمل الصحيح.
الخصوصية والأمان
Markdown من أكثر الصيغ احتمالًا لاحتوائه على أشياء لا تريدها على خادم: مفاتيح API في كتل الشيفرة، وعناوين URL داخلية في الروابط، ومسودّات منشورات لم تنشرها بعد، وأسماء عملاء في ملاحظات الاجتماعات. تضطر أدوات markdown-إلى-PDF القائمة على الخادم إلى استيعاب كل ذلك. وبنية هذه الأداة تعني أنك لست مضطرًا للوثوق بسياسة خصوصية — فببساطة لا توجد خطوة رفع في العملية. أوقِف شبكتك وسيظل التحويل يعمل بعد تحميل الصفحة.
الأسئلة الشائعة
نعم — يعمل المحلّل في وضع GFM، لذا فإن كتل الشيفرة المُسيّجة (بعلامات ``` الخلفية)، والشطب (~~text~~)، وقوائم المهام، والروابط التلقائية، وقواعد الفقرات المرنة في GFM تعمل جميعًا. وما لا ينجو من التحويل هو الجداول: ينتج marked عنصر HTML من نوع <table>، لكن عارض PDF في هذه الأداة لا يرسم خلايا الجداول، لذا سيخرج الجدول كأسطر نصية مُسطّحة. إذا كان ملف README لديك يعتمد بكثرة على الجداول، فاعرض الصفحة في GitHub أولًا ثم استخدم أداة HTML إلى PDF أو التقط لقطة شاشة لها للحصول على ناتج بشبكة حقيقية.
لا. تُعرض كتل الشيفرة بخط Courier ثابت العرض وبلون واحد كي تبقى المسافات البادئة وبنية الشيفرة مقروءة، لكن الرموز لا تُلوَّن بحسب اللغة. نتجنّب إبراز بناء الجملة عمدًا لأنه سيفرض تحميل مكتبة إبراز بحجم يتجاوز 200 كيلوبايت على صفحة مهمتها الأساسية هي التحويل إلى PDF، وعادةً ما تُطبع ملفات PDF أو تُؤرشف — لا تُقرأ كما في بيئة تطوير. إذا كانت الشيفرة الملوّنة مهمة، فالصق HTML المُبرز من محرّرك عبر أداة HTML إلى PDF لدينا بدلًا من ذلك.
تُسقَط وسوم الصور الخارجية () — لن تجلب الأداة الصور البعيدة. وهذا مقصود لسببين: الخصوصية (إذ سيُسرّب الجلب عنوان IP والمُحيل إلى مضيف الصورة) والموثوقية (لأن العرض المعتمد على الشبكة يعني ناتجًا غير متّسق). إذا احتجت إلى تضمين صور في PDF، فاستخدم أداتي JPG إلى PDF أو PNG إلى PDF لإضافتها كصفحات منفصلة، أو ادمجها مع ملف PDF المُنتَج من markdown بأداة دمج PDF.
لا. يبقى كل من مصدر markdown وملف PDF المُنتَج داخل علامة تبويب متصفحك بالكامل. فمحلّل marked، ومُجزّئ HTML إلى كتل، وpdf-lib كلها شيفرة JavaScript تعمل في جانب العميل تُحمَّل مرة واحدة على هذه الصفحة ثم تعمل محليًا. يمكنك التأكد من ذلك في علامة تبويب الشبكة بأدوات المطوّر في متصفحك — فبعد تحميل الصفحة، لا يُحدِث إنشاء ملف PDF أي طلبات شبكة صادرة. أغلِق علامة التبويب وسيختفي كل أثر؛ فلا يوجد ملف مؤقت من جانب الخادم لأنه لا توجد خطوة خادم.
تُعرض جميع مستويات العناوين الستة في markdown (من # إلى ######) كعناوين PDF بأحجام متناقصة (h1 هو الأكبر، وh6 بالكاد أكبر من نص المتن). يُحافَظ على التسلسل الهرمي كي تلتقط قارئات الشاشة وقارئات PDF المخطط العام. وداخل العناوين، يُحترَم التنسيق المضمّن (الغامق والمائل والشيفرة المضمّنة). ولا نولّد جدول محتويات تلقائيًا — فإذا احتاج مستندك إلى واحد، فأضِف قسم "## جدول المحتويات" بنفسك مع قائمة markdown بسيطة.
ليس في شكلها الشبكي. يحلّل marked الجدول على نحو صحيح إلى HTML، لكن عارض PDF لدينا بسيط عمدًا ولا يرسم حدود الخلايا ولا يوزّع الأعمدة. سيخرج الجدول كسلسلة من الأسطر النصية، صفًا تلو الآخر، وهو ما يكون عادةً غير مقروء لأي شيء يتجاوز مثالًا بحجم 2×2. إذا كانت الجداول ضرورية لمستندك، فإن سير العمل الصادق هو: اعرض إلى HTML في معاينك المفضّل، والتقط لقطة شاشة، واستخدم JPG إلى PDF — أو استخدم Pandoc محليًا للحصول على ناتج بجودة LaTeX كاملة. نحن صريحون بشأن هذا القيد بدلًا من التظاهر بعرض الجداول على نحو رديء.
نصائح للحصول على ناتج جيد
- استخدم عناوين حقيقية. علامة
#في بداية السطر تتحوّل إلى h1؛ والمستويات الأدنى تتداخل بنظافة. تلتقط قارئات PDF وقارئات الشاشة المخطط العام. - أبقِ كتل الشيفرة مُسيّجة. تُعرض الكتل ذات العلامات الخلفية الثلاثية بخط Courier، فتُقرأ المسافات البادئة على نحو صحيح حتى عند الالتفاف.
- تجنّب markdown الغني بالصور. لا تُنزَّل الصور الخارجية. حوّل الصور إلى PDF على حدة ثم ادمجها.
- للجداول، اعرض markdown في أداتك أولًا ثم التقط لقطة شاشة. أو استخدم Pandoc محليًا للجداول بجودة طباعية.
أدوات PDF ذات صلة
- HTML إلى PDF — محرّك العرض نفسه، بإدخال HTML بدلًا من markdown.
- TXT إلى PDF — نص عادي بلا أي تنسيق.
- دمج PDF — اجمع ملف PDF الخاص بـ markdown مع صور أو ملفات أخرى.
- ضغط PDF — قلّص الناتج لمشاركته.