UltKit

تبدیل Markdown به PDF

فایل .md یا .markdown را بارگذاری کنید و PDF تحویل بگیرید که در آن # به تیتر، **bold** به متن پررنگ و جدول با خط عمودی به جدول واقعی تبدیل شده است. این سریع‌ترین راه برای فرستادن یک README، صورت‌جلسه یا مستند فنی به کسی است که اصلاً Markdown را نمی‌شناسد.

تبدیل به PDF

یا فایل‌های DOC, DOCX, DOCM … را اینجا رها کنید ·

حداکثر 95 MB برای هر فایل· تا 20 فایل· حذف پس از 30 دقیقه

خروجی

فایل‌ها روی سرورهای ما پردازش می‌شوند و پس از 30 دقیقه حذف می‌شوند.

نحوه استفاده از این ابزار

  1. 1

    فایل .md را بارگذاری کنید

    یک فایل Markdown یا حداکثر ۲۰ فایل را همزمان اضافه کنید که هرکدام تا 95 MB باشد. اگر فایل در GitHub است، آن را باز کنید، نسخهٔ raw را دانلود کنید و همان را بارگذاری کنید.

  2. 2

    گزینه‌های صفحه و بوکمارک را بررسی کنید

    گزینهٔ نشانک از روی سرفصل‌ها روشن است، پس سرفصل‌ها در نوار کناری PDF نمایش داده می‌شوند. حاشیه‌ها از حالت Normal شروع می‌شود؛ برای چاپ، اندازهٔ صفحه را در تنظیمات پیشرفته روی A4 یا Letter بگذارید.

  3. 3

    به PDF تبدیل کنید

    روی تبدیل به PDF بزنید و سند آماده را دانلود کنید. فایل بارگذاری‌شده و PDF پس از 30 دقیقه حذف می‌شوند.

پاسخ

چطور Markdown را به PDF تبدیل کنم؟

فایل .md را بارگذاری کنید و روی تبدیل به PDF بزنید. ابتدا Markdown رندر می‌شود، پس PDF به‌جای نمادهای خام، سرفصل‌ها، فهرست‌ها، پیوندها، جدول‌ها و کد را قالب‌بندی‌شده نشان می‌دهد.

Markdown، CommonMark و GFM: کدام نحو در PDF شناخته می‌شود

  1. 2004

    Markdown

    John Gruber با مشارکت Aaron Swartz این نحو و یک اسکریپت Perl را منتشر می‌کند. قواعد بسیاری از حالت‌های مرزی را مبهم رها می‌کنند.

  2. 2014

    CommonMark

    گروهی شامل John MacFarlane مشخصاتی بدون ابهام همراه با موارد آزمون منتشر می‌کند که ابتدا با نام Standard Markdown اعلام شد.

  3. 2016

    text/markdown

    RFC 7763 نوع رسانهٔ رسمی فایل‌های Markdown را ثبت می‌کند.

  4. 2017

    GFM spec

    GitHub قالب GitHub Flavored Markdown را به‌صورت ابرمجموعهٔ دقیق CommonMark منتشر می‌کند و جدول، فهرست وظایف و خط‌خورده را به آن می‌افزاید.

ابهام اولیه دلیل آن است که یک فایل واحد در GitHub، VS Code، Obsidian و مولد سایت ایستا کمی متفاوت رندر می‌شود. دو خط خالی، فهرست تو در تو با دو فاصله به‌جای چهار، یا سرفصلی بدون فاصله پس از # می‌تواند نتیجه را تغییر دهد. فایل‌هایی که طبق CommonMark و در صورت نیاز با جدول‌های GFM نوشته شده‌اند تقریباً همه‌جا یکسان رندر می‌شوند، از جمله در این مبدل.

اگر فایل شما در واقع یادداشت ساده بدون نحو Markdown است، صفحهٔ متن به PDF آن را دقیقاً همان‌طور که تایپ شده چاپ می‌کند. اگر محتوا را به‌صورت صفحهٔ وب دارید، HTML به PDF استایل خود سایت را حفظ می‌کند.

هر عنصر Markdown در PDF به چه چیزی تبدیل می‌شود

نحوهای رایج و شکل نمایش آن‌ها در صفحه
عنصرMarkdownدر PDF
سرفصل‌ها`#` to `######`سرفصل‌هایی با اندازهٔ متفاوت؛ با روشن بودن **نشانک از روی سرفصل‌ها**، موارد در نوار کناری PDF
تأکید`**پررنگ**`، `*مورب*`، `~~خط‌خورده~~`متن پررنگ، مورب و خط‌خورده
فهرست‌ها`-`, `*`, `1.`فهرست‌های نقطه‌ای و شماره‌دار، تو در تو بر پایهٔ تورفتگی
پیوندها`[label](https://…)`متن قابل‌کلیک؛ پیوندهای نسبی مقصد خود را از دست می‌دهند
کدبک‌تیک و بلوک‌های fenced ‎```‎متن تک‌فاصله روی بلوکی سایه‌دار؛ خطوط را کوتاه نگه دارید تا در عرض صفحه جا شوند
جدول‌هاجدول‌های pipe در GFMجدول‌های خط‌دار؛ جدول‌های عریض در حالت افقی بهتر جا می‌شوند
تصاویر`![alt](https://…)`وقتی نشانی یک URL کامل و عمومی باشد نمایش داده می‌شود

MD

Markdown

Markdown یک نحو نشانه‌گذاری سبک است که John Gruber در سال 2004 ساخت. از نمادهای متن ساده مانند # برای عنوان، * برای تأکید و - برای فهرست استفاده می‌کند که به صورت متن خام هم خوانا می‌مانند و به‌خوبی به HTML تبدیل می‌شوند. این قالب استاندارد فایل‌های README، مستندات، ویکی‌ها، برنامه‌های یادداشت و بسیاری از مولدهای سایت ایستا است. گویش‌های مختلفی مانند CommonMark و GitHub Flavored Markdown وجود دارد که در جزئیاتی مثل جدول‌ها فرق دارند. هر ویرایشگر متنی می‌تواند فایل‌های .md را باز کند.

فشرده‌سازی
–
شفافیت
–
انیمیشن
–
سال معرفی
2004 · John Gruber
مبدل MD

PDF

فرمت سند قابل‌حمل

PDF را Adobe در سال ۱۹۹۳ ساخت و در سال ۲۰۰۸ به استاندارد باز ISO 32000 تبدیل شد. متن، فونت‌ها، تصاویر و چیدمان را ثابت نگه می‌دارد تا سند روی هر صفحه‌نمایش و چاپگر یکسان دیده شود. PDF می‌تواند شامل فرم، امضا، پیوند، پیوست و متن قابل جست‌وجو باشد و نوع PDF/A برای بایگانی بلندمدت به کار می‌رود. چیدمان ثابت ویرایش PDF را دشوار می‌کند و PDFهای اسکن‌شده تا وقتی OCR اعمال نشود فقط تصویر دارند. همه مرورگرها و سیستم‌عامل‌ها می‌توانند آن را باز کنند.

فشرده‌سازی
–
شفافیت
بله
انیمیشن
خیر
سال معرفی
1993 · Adobe
مبدل PDF

Markdown تا وقتی رندرکننده‌ای نمادهایش را به قالب‌بندی تبدیل نکند تمام‌شده به نظر نمی‌رسد و بیشتر گیرندگان رندرکننده ندارند؛ PDF به‌جای علامت # و ستاره، همان سرفصل‌ها، جدول‌ها و بلوک‌های کدی را نشان می‌دهد که مدنظر شما بوده است.

امکانات جانبی Markdown که تبدیل نمی‌شوند

نمودارها، فرمول‌های ریاضی و front matter به صورت متن می‌مانند

نمودارهای Mermaid، فرمول‌های LaTeX میان علامت دلار، YAML front matter در ابتدای فایل و جاسازی‌های مخصوص هر برنامه افزونه‌هایی هستند که هم از CommonMark و هم از مشخصات GFM بیرون‌اند. نمودارها و فرمول‌ها را به‌صورت تصویر خروجی بگیرید و پیوند دهید، و اگر نمی‌خواهید front matter در صفحهٔ اول چاپ شود، آن بلوک را حذف کنید.

پرسش‌های رایج دربارهٔ تبدیل Markdown به PDF

فایل من باید از کدام نسخهٔ Markdown پیروی کند تا PDF تمیزی بدهد؟

از CommonMark به‌علاوهٔ افزوده‌های GitHub استفاده کنید که بیشتر ویرایشگرها پشتیبانی می‌کنند: جدول‌های pipe، بلوک‌های کد fenced و خط‌خورده. نحوی که فقط یک برنامه می‌فهمد، مانند لینک‌های سبک ویکی، بیشتر احتمال دارد به‌صورت متن ساده درآید.

چطور عکس‌های فایل Markdown را در PDF حفظ کنم؟

فقط فایل .md بارگذاری می‌شود، پس تصویری که با مسیر نسبی مثل ./img/chart.png نوشته شده مقصدی برای اشاره ندارد. تصاویر را با نشانی کامل https:// پیوند دهید، یا متن را در سندی که تصاویر را دارد بچسبانید و آن را تبدیل کنید.

آیا می‌توانم یادداشت‌های خروجی گرفته از Obsidian یا Notion را تبدیل کنم؟

بله، هر دو فایل استاندارد .md خروجی می‌دهند. Notion تصاویر را در پوشه‌ای جدا می‌گذارد و یادداشت‌های Obsidian اغلب از [[wiki links]] و جاسازی‌هایی استفاده می‌کنند که Markdown استاندارد نیستند؛ پس انتظار داشته باشید به‌صورت متن خام دیده شوند و آن‌ها را پیش‌تر با پیوندهای معمولی جایگزین کنید.

آیا می‌توانم فونت PDF ساخته‌شده از Markdown را انتخاب کنم؟

تنظیم فونت وجود ندارد؛ مبدل برای متن اصلی یک فونت خوانا و برای کد یک فونت تک‌فاصله به کار می‌برد. اندازهٔ صفحه، جهت، حاشیه‌ها، رمز عبور و PDF/A همگی در تنظیمات پیشرفته هستند.

Markdown را به صورت PDF بفرستم یا فایل ورد؟

PDF وقتی که افراد باید سند را همان‌طور که هست بخوانند، چاپ کنند یا امضا کنند. اگر بازبین بخواهد متن را با تغییرات ردیابی‌شده ویرایش کند، Markdown به Word سندی قابل‌ویرایش با همان سرفصل‌ها و فهرست‌ها می‌دهد.