Markdown به PDF
Markdown را جایگذاری کنید یا یک فایل .md را رها کنید. سازگار با Markdown بهسبک GitHub. ۱۰۰٪ درون مرورگر شما: چیزی آپلود نمیشود.
یک فایل .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 با قواعد GFM فعال (کد محصور، خطخورده، فهرستهای وظیفه و پیوندهای خودکار) markdown را به HTML تبدیل میکند.
- یک توکنکننده کوچک مبتنی بر regex روی 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 اجرا میشود، بنابراین بلوکهای کد محصور (با بکتیک ```)، خطخورده (~~متن~~)، فهرستهای وظیفه، پیوندهای خودکار و قواعد پاراگراف آزاد GFM همگی کار میکنند. چیزی که از تبدیل جان سالم به در نمیبرد جدولهاست: marked یک