مبدل Markdown به PDF

یک مبدل Markdown به PDF، متن منبع Markdown را به یک سند پی‌دی‌اف ثابت و غیرقابل تغییر تبدیل می‌کند.

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

عبارت «MD به PDF» نیز دقیقاً به همین معناست. MD مخفف رایج Markdown است و .md پسوند فایلی است که معمولاً برای اسناد Markdown استفاده می‌شود.

یک فایل .md سندی متنی با ساختار Markdown است. SolConverter فایل‌های منبع .md و .txt را پذیرفته و محتوای Markdown پشتیبانی‌شده را از طریق یک جریان کار آنلاین به PDF تبدیل می‌کند.

این ابزار زمانی بسیار کاربردی است که می‌خواهید Markdown را به عنوان منبع قابل ویرایش حفظ کنید، اما برای ارائه به مشتریان، همکاران، دانشجویان، داوران یا افرادی که با فرمت Markdown آشنایی ندارند، به یک سند ثابت نیاز دارید.

روش‌های رایج برای توصیف این کار عبارتند از:

• Markdown به PDF
• MD به PDF
• فایل Markdown به PDF
• فایل .md به PDF
• تبدیل Markdown به PDF
• خروجی گرفتن از Markdown به صورت PDF
• ذخیره Markdown به عنوان PDF

تمام این نیازهای تبدیل توسط این صفحه برطرف می‌شوند.

SolConverter ساختارهای متداول Markdown را که در اسناد فنی و عمومی استفاده می‌شوند، رندر می‌کند.

محتوای پشتیبانی‌شده شامل موارد زیر است:

• سرصفحه‌های ATX و Setext؛
• پاراگراف‌ها، شکستگی‌های خط و خطوط افقی؛
• متن‌های ضخیم (bold)، مورب (italic) و خط‌خورده (strikethrough)؛
• لیست‌های مرتب و نامرتب، از جمله لیست‌های تو در تو؛
• لیست وظایف GFM همراه با چک‌باکس؛
• نقل‌قول‌ها و نقل‌قول‌های تو در تو؛
• کدهای درون‌خطی و بلوک‌های کد محصور (fenced code blocks)؛
• لینک‌های Markdown، لینک‌های خودکار وب و لینک‌های خودکار ایمیل؛
• جدول‌های GFM با ترازهای چپ، وسط و راست؛
• جدول‌های HTML خام و امن با امکان کنترل rowspan و colspan؛
• عناصر سند مانند details، summary، kbd، sub، sup، figure و figcaption؛
• لنگرهای سرصفحه (heading anchors)؛
• فرانت‌مترهای YAML در ابتدای فایل که به عنوان فراداده در نظر گرفته می‌شوند و چاپ نخواهند شد.

بلوک‌های کد یا جداکننده‌های نامعتبر به صورت محلی ایزوله می‌شوند تا وجود مشکل در قالب‌بندی بخشی از سند، بقیه سند را تحت تأثیر قرار ندهد.

SolConverter فرمت‌های پشتیبانی‌شده LaTeX و MathML را به صورت MathJax SVG رندر می‌کند. خروجی SVG هنگام زوم کردن روی PDF یا چاپ آن کاملاً واضح و باکیفیت باقی می‌ماند.

سیستم پردازش ریاضی معادلات را قبل از تجزیه (parsing) متن Markdown شناسایی می‌کند که این امر به محافظت از خطوط زیرین، ستاره‌ها، جداکننده‌های نمایش و محیط‌های معادله در برابر تغییر توسط تجزیه‌کننده Markdown کمک می‌کند.

ورودی‌های ریاضی پشتیبانی‌شده عبارتند از:

• ریاضی درون‌خطی (inline math) با $...$ و \(...\)؛
• ریاضی نمایشی (display math) با $$...$$ و \[...\]؛
• محیط‌های رایج AMS مانند equation، align، gather، multline، split و cases؛
• کسرها، ریشه‌ها، توان‌ها، اندیس‌ها، مجموع‌ها، ضرب‌ها، انتگرال‌ها، حدها و سری‌ها؛
• ماتریس‌ها، دترمینان‌ها، آرایه‌ها و نمادگذاری‌های تانسور؛
• نمادگذاری‌های حساب دیفرانسیل و انتگرال، معادلات دیفرانسیل، جبر خطی، احتمال، آمار، فیزیک و شیمی؛
• فرمت‌های Presentation MathML و عملیات‌های پایه‌ای Content MathML؛
• عبارت‌های شیمی نوشته شده با \ce{...}؛
• ماکروهای تعریف‌شده در سطح سند مانند \newcommand و \DeclareMathOperator.

معادلات جمعی طولانی را می‌توان به جای بریده شدن در لبه صفحه یا کوچک شدن تا حد ناخوانایی، در اپراتورهای سطح بالا شکست. معادلات نمایشی در صورتی که مرورگر بتواند بلوک را در صفحه جا دهد، به صورت یکپارچه حفظ می‌شوند.

SolConverter ریاضیات نامعتبر و خراب را در همان نقطه‌ای که مشکل رخ داده است ایزوله می‌کند.

هنگامی که یک بلوک LaTeX یا MathML نتواند به صورت امن رندر شود، مبدل می‌تواند متن منبع خامی را به عنوان گزینه جایگزین (fallback) حفظ کرده و به رندر بقیه محتوای معتبر ادامه دهد. همین رویکردِ مدیریت خطای محلی برای نمودارها و تصاویر نیز استفاده می‌شود.

این ویژگی برای اسناد فنی طولانی بسیار حیاتی است. وجود یک معادله آسیب‌دیده، یک تصویر از دست رفته یا یک نمودار نامعتبر نباید باعث شود که کل صفحات معتبر پیرامون آن بلافاصله از دست بروند.

بلوک‌های محصور Mermaid پشتیبانی‌شده به صورت SVG در داخل PDF رندر می‌شوند. ZenUML نیز از طریق یکپارچه‌سازی نمودار خارجی Mermaid که به صورت محلی بسته‌بندی شده، پشتیبانی می‌شود.

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

موتورهای نمودار پشتیبانی‌شده فعلی Mermaid و ZenUML هستند. فرمت‌های PlantUML، Graphviz، D2، WaveDrom، BPMN، Nomnoml و TikZ کامل در حال حاضر پشتیبانی نمی‌شوند.

اسناد فنی معمولاً ترکیبی از توضیحات، دستورات، تنظیمات و کدهای منبع هستند. SolConverter در صورت شناسایی زبان بلوک کد، از Highlight.js برای اعمال برجسته‌سازی سینتکس استفاده می‌کند.

خروجی کد شامل موارد زیر است:

• یک فونت اختصاصی تک‌فاصله (monospace)؛
• پس‌زمینه، کادر و فاصله‌گذاری (padding) مشخص برای بلوک‌های کد؛
• تشخیص زبان برنامه نویسی از روی رشته اطلاعات بلوک کد؛
• خروجی امن متن منبع در صورت عدم شناسایی زبان؛
• محافظت در برابر تفسیر جداکننده‌های ریاضی در داخل کدهای برنامه‌نویسی؛
• ایزوله‌سازی چپ‌به‌راست برای کدهای داخل اسناد راست‌به‌چپ.

بنابراین، PDF کد را به صورت بصری از متن‌های اطراف جدا نگه می‌دارد در حالی که متن منبع اصلی را به همان شکل حفظ می‌کند.

SolConverter جهت متن سند را از روی محتوای آن تشخیص می‌دهد و از اسناد PDF چندزبانه با فونت‌های جایگزین مناسب پشتیبانی می‌کند.

سناریوهای متنی پشتیبانی‌شده عبارتند از:

• زبان ویتنامی و کاراکترهای لاتین بسط‌یافته؛
• چیدمان متون عربی و عبری؛
• متون چینی، ژاپنی و کره‌ای؛
• نویسه‌های هندی؛
• خطوط سیریلیک و یونانی؛
• اسناد با خطوط ترکیبی؛
• علائم ترکیبی؛
• بسیاری از نمادهای یونیکد و ایموجی‌ها، بسته به پوشش فونت‌های در دسترس.

ریاضیات و کدها حتی زمانی که جهت سند اصلی راست‌به‌چپ باشد، به صورت چپ‌به‌راست باقی می‌مانند.

SolConverter از تصاویر آدرس‌های عمومی HTTP و HTTPS و همچنین تصاویر داده‌ای base64 معتبر در فرمت‌های PNG، GIF، JPEG، WebP و SVG پشتیبانی می‌کند.

تصاویر به عرض صفحه محدود می‌شوند در حالی که نسبت ابعاد (aspect ratio) آن‌ها حفظ می‌شود. فراداده‌های تصویر پشتیبانی‌شده شامل متن جایگزین (alt text)، عنوان، ابعاد امن، تراز، اشکال و توضیحات تصویر است.

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

برای حفظ امنیت، مسیرهای محلی، آدرس‌های localhost، مقادیر آی‌پی خصوصی، آدرس‌های URL دارای javascript: و پروتکل‌های پشتیبانی‌نشده مسدود می‌شوند. پوشه‌های دارایی مرتبط با مخزن به صورت خودکار همراه با فایل Markdown آپلود شده بسته‌بندی نمی‌شوند.

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

فرم وب فعلی از تنظیمات زیر استفاده می‌کند:

• اندازه صفحه A4؛
• جهت عمودی (portrait)؛
• حاشیه‌های تنظیم‌شده برای خروجی خوانا؛
• شماره‌گذاری صفحات در قالب current / total؛
• عنوان خروجی بر اساس نام فایل منبع؛
• چاپ رنگ‌های پس‌زمینه.

سیستم رندر همچنین حفاظت‌های پایه‌ای برای چیدمان چاپ اعمال می‌کند. این سیستم تلاش می‌کند از قرار گرفتن سرصفحه‌ها به تنهایی در پایین صفحه جلوگیری کند، خطوط اول و آخر پاراگراف که در صفحات جدا افتاده‌اند (widows and orphans) را کاهش دهد، سرصفحه‌های جدول را در صورت پشتیبانی مرورگر در صفحات بعدی تکرار کند، و از شکستن بلوک‌های کد، ردیف‌های جدول، شکل‌ها، تصاویر، نمودارها و معادلات نمایشی در صورت وجود فضای کافی در صفحه جلوگیری نماید.

خروجی گرفتن از فایل‌های Markdown ساده راحت است. اما اسناد فنی طولانی Markdown دشوارتر هستند، زیرا ریاضیات، نمودارها، جدول‌ها، کدها، متون چندزبانه، تصاویر خارجی و صفحه‌بندی همگی با یکدیگر تعامل دارند.

طراحی SolConverter بر اساس این حالت‌های پیچیده‌تر و پرتقاضاتر صورت گرفته است. سیستم تبدیل Markdown به PDF آن شامل رندرینگ MathJax SVG، پشتیبانی از Mermaid و ZenUML، برجسته‌سازی سینتکس، پشتیبانی از یونیکد و متون راست‌به‌چپ (RTL)، پاک‌سازی محتوا، کنترل‌های شبکه، ایزوله‌سازی خطاهای سطح بلوک، نمایش پیشرفت تبدیل، و نتایج مجزای پیش‌نمایش و دانلود است.

در تست‌های فشار داخلی که در تاریخ ۴ اوت ۲۰۲۶ انجام شد، رندرکننده یک فایل PDF با ۱۵۶ صفحه را از یک ساختار آزمایشی مصنوعی شامل ۹۲ بخش و ۳۳۳ عبارت MathJax تولید کرد. این تست همچنین شامل کدهای MathML به طور عمدی خراب و یک معادله طولانی ۸۴ جمله‌ای بود تا رفتار سیستم در برابر خطاهای محلی و شکستن خطوط بررسی شود. این‌ها شرایط آزمایش داخلی هستند و تضمینی برای دریافت نتیجه مشابه برای هر سند متفاوتی نیست.

فایل‌های Markdown آپلود شده می‌توانند حاوی کدهای HTML خام، آدرس‌های تصویر و سایر محتواهایی باشند که نباید به صورت خودکار به آن‌ها اعتماد کرد.

SolConverter کدهای HTML رندر شده را با استفاده از یک لیست سفید (allowlist) پاک‌سازی می‌کند، اسکریپت‌ها و رویدادگیرها را حذف می‌کند، آدرس‌های URL ناامن را رد می‌کند، ادغام سلول‌های جدول را محدود می‌سازد، سیاست‌های امنیتی محتوای سخت‌گیرانه‌ای اعمال می‌کند و درخواست‌های مرورگر را که خارج از سیاست‌های تصویر باشد، مسدود می‌کند.

تصاویر داده‌ای معتبر می‌توانند بدون نیاز به درخواست شبکه رندر شوند. تصاویر از راه دور عمومی از طریق سیاست‌های تصویر مجاز هستند، در حالی که آدرس‌های محلی، خصوصی و پشتیبانی‌نشده مسدود می‌شوند.

آپلودهای جدید در صورتی که تبدیل آن‌ها آغاز نشده باشد، پس از ۱۵ دقیقه منقضی می‌شوند. پس از تبدیل موفقیت‌آمیز، فایل منبع بلافاصله پس از تأیید خروجی حذف می‌شود؛ ورودی‌های ناموفق نیز با همان مهلت ۱۵ دقیقه‌ای اولیه منقضی خواهند شد. پی‌دی‌اف‌های نهایی تا دو ساعت در دسترس باقی می‌مانند. برای مشاهده چرخه حیات کامل داده‌ها به سیاست حریم خصوصی مراجعه کنید.

فرمت Markdown برای نوشتن و کنترل نسخه بسیار کارآمد است. فرمت PDF زمانی مفید است که سند به ظاهری ثابت و یک فرمت توزیع با پشتیبانی گسترده نیاز داشته باشد.

شما ممکن است در شرایط زیر نیاز به تبدیل Markdown به PDF داشته باشید:

• ارسال مستندات فنی به خارج از مخزن پروژه؛
• ارائه یک گزارش، مشخصات فنی، پروپوزال یا سند راهنمای نهایی و غیرقابل تغییر؛
• ایجاد یادداشت‌های درسی یا مطالب آموزشی قابل چاپ؛
• توزیع فایل README یا لیست تغییرات برای خوانندگان غیرفنی؛
• بررسی معادلات و نمودارها در یک قالب مبتنی بر صفحه؛
• بایگانی کردن نسخه خاصی از یک سند در حال تغییر؛
• اشتراک‌گذاری مستندات بدون نیاز به نصب ویرایشگر Markdown؛
• حفظ منبع Markdown قابل ویرایش و تولید یک فایل خروجی مجزا.

یک مبدل آنلاین Markdown به PDF زمانی بهترین گزینه است که بدون نیاز به تنظیم ابزارهای محلی، به جریان کاری شامل آپلود مستقیم، رندر مدیریت‌شده، پیش‌نمایش و دانلود نیاز دارید.

یک ابزار محلی مانند Pandoc یا یک افزونه ویرایشگر کد زمانی انتخاب بهتری است که به تبدیل آفلاین، قالب‌های سفارشی، استایل‌های CSS دلخواه، پردازش ارجاعات، جریان ساخت اسکریپت‌شده یا تبدیل دسته‌ای فایل‌ها در مخزن نیاز دارید.

SolConverter بر روی رندرینگ مدیریت‌شده Markdown به PDF برای اسناد آپلود شده تکی تمرکز دارد. این سیستم در حال حاضر پشتیبانی کامل از ارجاعات Pandoc، فایل‌های CSS شخصی‌سازی‌شده کاربر، بوک‌مارک‌های خودکار پی‌دی‌اف، پوشه‌های دارایی نسبی بسته‌بندی‌شده یا تمامی زبان‌های ترسیم نمودار را ارائه نمی‌دهد.

مستندات فنی

یادداشت‌های معماری پروژه، توضیحات API، کتاب‌های راهنما، اسناد انتشار نسخه، مشخصات فنی و راهنماهای داخلی را به یک PDF ثابت تبدیل کنید.

اسناد ریاضی و علمی

فرمت‌های LaTeX، MathML، ماتریس‌ها، معادلات، نمادگذاری شیمی و عبارت‌های طولانی پشتیبانی‌شده را به صورت ریاضیات مبتنی بر SVG در داخل PDF رندر کنید.

مستندات توسعه‌دهندگان

بلوک‌های کد، کدهای درون‌خطی، جدول‌ها، لیست وظایف، نمودارها و توضیحات ساختاریافته را در یک سند منسجم نگه دارید تا خارج از مخزن پروژه قابل بررسی باشد.

گزارش‌های چندزبانه

ایجاد فایل‌های پی‌دی‌اف حاوی زبان‌های ویتنامی، چینی و ژاپنی و کره‌ای، عربی، عبری، سیریلیک، یونانی، خطوط هندی و محتواهای ترکیبی چپ‌به‌راست و راست‌به‌چپ.

یادداشت‌ها، گزارش‌ها و پروپوزال‌ها

متن خود را در Markdown بنویسید، سپس یک سند ثابت برای چاپ، تأیید، اشتراک‌گذاری یا بایگانی ایجاد کنید.

اگر فرمت منبع یا خروجی مورد نظر شما متفاوت است، از ابزار دیگر SolConverter استفاده کنید.

• تبدیل فایل‌ها به Markdown
• تبدیل PDF به Markdown
• تبدیل Word به Markdown
• تبدیل HTML به Markdown
• تبدیل Excel به Markdown
• تبدیل CSV به Markdown
• مشاهده مبدل‌های داده
• تبدیل JSON به CSV
• تبدیل CSV به JSON
• مطالعه راهنمای فنی تبدیل Markdown به PDF