راهنما: تبدیل و خروجی گرفتن Markdown به صفحه وب HTML
شما میتوانید سند فعال خود را به یک فایل مستقل و زیبای .html تبدیل کنید تا در هر زمان، هر مکان و روی هر دستگاهی آن را بخوانید.
🌐 خروجی HTML چیست و چه مزایایی دارد؟
فایلهای استاندارد Markdown برای خواندن به نمایشگرهای خاصی نیاز دارند. اگر سند خود را به یک صفحه وب HTML ایستا صادر کنید:
- بدون هیچ وابستگی: صفحه
.htmlخروجی را میتوان با دو بار کلیک، فوراً در هر مرورگری در تلفنها، تبلتها یا رایانهها بدون نیاز به هیچ افزونهای مشاهده کرد. - نمودارها و فرمولهای تعبیه شده: نمودارهای Mermaid، تصویرسازیهای داده Vega-Lite و معادلات KaTeX قبل از خروجی گرفتن، به کدهای ایستای درونخطی یا SVGها کامپایل میشوند و حتی به صورت آفلاین نیز به خوبی رندر میشوند.
- آماده برای میزبانی و اشتراکگذاری: فایل HTML را روی سرور خود، GitHub Pages یا Netlify آپلود کنید تا مستندات محصول، وبلاگها یا دفترچههای راهنما را فوراً منتشر کنید.
🚀 مراحل تبدیل و خروجی گرفتن به HTML
۱
باز کردن پنل خروجی
روی دکمه "خروجی گرفتن" در سمت راست نوار ابزار هدر کلیک کنید (یا نشانگر را روی یک یادداشت در لیست نوار کناری ببرید و روی نماد "خروجی" کلیک کنید).
۲
انتخاب فرمت HTML
در کشوی گزینههای خروجی، روی کارت "خروجی صفحه وب HTML (.html)" کلیک کنید.
۳
تولید و دانلود
ویرایشگر موتور رندر
MarkdownToHtml را راهاندازی میکند، پوسته GitHub Light، برجستهساز نحو Prism و داراییهای KaTeX را بارگذاری میکند و نمودارهای Mermaid را به طور موازی پردازش میکند. پس از اتمام، مرورگر شما فایل مستقل با نام [filename]_it365.janqi.com__.html را دانلود خواهد کرد.
💡 نکات و جزئیات طراحی
- HTML صادر شده به طور پیشفرض از سبک زیبا و شیک GitHub Markdown استفاده میکند و خوانایی بسیار خوبی را برای اسناد طولانی فراهم میکند.
- نمودارها به صورت فایلهای SVG بدون افت کیفیت و با وضوح بالا در داخل فایل HTML تعبیه میشوند و این اطمینان را میدهند که در هنگام بزرگنمایی یا کوچکنمایی واضح باقی میمانند.