پرسش‌های متداول

پاسخ پرسش‌های رایج درباره MarkPDF

این ابزار از چه نحوی از Markdown پشتیبانی می‌کند؟

MarkPDF از نحو CommonMark پشتیبانی می‌کند: عنوان‌ها، پاراگراف‌ها، تأکید، فهرست‌ها، لینک‌ها، تصویرها، بلوک‌های کد، نقل‌قول‌ها و خط جداکننده، به‌علاوه جدول‌های سبک GitHub، متن خط‌خورده و لینک خودکار. فرمول‌های ریاضی با $ … $ و $$ … $$ پشتیبانی می‌شوند.

PDF متنی یا تصویری: چه فرقی دارند؟

دو روش خروجی وجود دارد. «دانلود PDF (متنی)» از موتور چاپ مرورگر شما استفاده می‌کند: متن قابل انتخاب و جستجو می‌ماند، لینک‌ها کار می‌کنند و حجم فایل کم است؛ در پنجره چاپ «ذخیره به‌عنوان PDF» را انتخاب کنید. «دانلود سریع (تصویری)» صفحه‌ها را با یک کلیک به‌صورت تصویر ذخیره می‌کند (حدود 180 DPI روی A4): دقیقاً شبیه پیش‌نمایش است، اما متن قابل انتخاب نیست و جستجو یا سامانه‌های غربالگری رزومه آن را نمی‌خوانند. در مرورگرهای داخلی برنامه‌ها (تلگرام، اینستاگرام، واتس‌اپ…) ممکن است چاپ در دسترس نباشد، پس نسخه تصویری اول نشان داده می‌شود.

آیا فرمول ریاضی و رنگ‌آمیزی کد پشتیبانی می‌شود؟

بله. بلوک‌های کد با highlight.js رنگ‌آمیزی می‌شوند (بیش از ۱۹۰ زبان برنامه‌نویسی) و ریاضی داخل $ … $، $$ … $$، \( … \) یا \[ … \] با KaTeX رندر می‌شود.

آیا محدودیت حجم فایل وجود دارد؟

همه پردازش در مرورگر انجام می‌شود، پس محدودیت واقعی به توان دستگاه شما بستگی دارد. معمولاً فایل‌های Markdown چند ده کیلوبایتی (چند ده هزار کلمه) بدون مشکل پردازش می‌شوند. سندهای خیلی بزرگ ممکن است برای رندر کمی بیشتر زمان بخواهند.

فونت مناسب را چطور انتخاب کنم؟

فونت فارسی، عربی و اردو بسته به متن خودکار بارگذاری می‌شود و لازم نیست چیزی انتخاب کنید. برای چینی ساده‌شده Noto Sans SC یا Source Han Sans، برای چینی سنتی Noto Sans TC، برای ژاپنی Noto Sans JP و برای کره‌ای Noto Sans KR را انتخاب کنید. برای سندهای چندزبانه Source Han Sans پیشنهاد می‌شود.

تبدیل چقدر سریع است؟

سرعت به طول و پیچیدگی سند بستگی دارد. یک مقاله معمولی ۲۰۰۰ کلمه‌ای معمولاً ۲ تا ۳ ثانیه طول می‌کشد. سندهای طولانی با جدول یا بلوک کد زیاد ممکن است ۵ تا ۱۰ ثانیه زمان ببرند. کل فرایند در مرورگر شما و بدون انتقال در شبکه انجام می‌شود.

آیا محتوای سند مرا ذخیره می‌کنید؟

خیر. همه پردازش MarkPDF به‌صورت محلی در مرورگر شما انجام می‌شود و محتوای سند هرگز به سرورهای ما فرستاده نمی‌شود. حریم خصوصی دلیل اصلی انتخاب رندر در مرورگر بوده است.

آیا تبدیل گروهی پشتیبانی می‌شود؟

نسخه فعلی هر بار یک سند را تبدیل می‌کند. تبدیل گروهی هنوز در دسترس نیست.

آیا می‌توانم ظاهر PDF را سفارشی کنم؟

در پنل تنظیمات می‌توانید فونت، اندازه فونت، اندازه کاغذ (A4، Letter، A5) و حاشیه‌ها را انتخاب کنید؛ انتخاب‌های شما روی همین دستگاه به خاطر سپرده می‌شود. CSS سفارشی و سرصفحه/پاصفحه هنوز در دسترس نیست.

آیا API در دسترس است؟

در حال حاضر API وجود ندارد. MarkPDF کاملاً در مرورگر اجرا می‌شود. اگر می‌خواهید ساخت PDF را در برنامه خودتان قرار دهید، کتابخانه‌های متن‌باز مورد استفاده ما (markdown-it و html2pdf.js) را ببینید.

از چه مرورگرهایی پشتیبانی می‌شود؟

MarkPDF روی همه مرورگرهای مدرن کار می‌کند: Chrome 80+، Firefox 75+، Safari 14+ و Edge 80+. برای بهترین تجربه، آخرین نسخه Chrome یا Edge را پیشنهاد می‌کنیم. Internet Explorer پشتیبانی نمی‌شود.

روی موبایل هم کار می‌کند؟

بله. طراحی واکنش‌گرا است و روی گوشی و تبلت کار می‌کند. در صفحه‌های کوچک ویرایشگر و پیش‌نمایش زیر هم قرار می‌گیرند؛ برای جابه‌جایی بین ویرایش و پیش‌نمایش دکمه «پیش‌نمایش» را بزنید.

آیا می‌توان تصویر اضافه کرد؟

بله. با نحو معمول تصویر در Markdown تصویرهای آنلاین را اضافه کنید. نسخه فعلی آپلود تصویر از دستگاه را پشتیبانی نمی‌کند؛ ابتدا تصویر را در یک سرویس میزبانی تصویر بارگذاری کنید و سپس از لینک آن استفاده کنید.

آیا خروجی به قالب‌های دیگر ممکن است؟

در حال حاضر خروجی اصلی PDF است. خروجی HTML در دست ساخت است و قالب‌های دیگر مانند Word ‏(.docx) شاید در نسخه‌های بعدی اضافه شوند.

کجا کمک بگیرم؟

MarkPDF پشتیبانی فردی ارائه نمی‌دهد. پاسخ بیشتر پرسش‌ها در همین صفحه، آموزش و راهنماهای رفع مشکل آمده است؛ این راهنماها مشکلات فونت، رمزگذاری و صفحه‌آرایی را با جزئیات توضیح می‌دهند.