مبدل رایگان

علامت گذاری به مبدل HTML

با پشتیبانی از پیش نمایش زنده، متن Markdown را به کد HTML آماده برای تولید تبدیل کنید.

درباره این ابزار

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

این مبدل از کتابخانه علامت‌گذاری شده استفاده می‌کند، که به‌طور گسترده‌ترین رندر Markdown در جاوا اسکریپت مورد استفاده قرار می‌گیرد. Marked از CommonMark و GitHub Flavored Markdown (GFM) پشتیبانی می‌کند، که به معنای جداول، بلوک‌های کد محصور شده، لیست‌های وظایف، خط‌بندی و پیوند خودکار همه کارها به درستی علاوه بر ویژگی‌های استاندارد Markdown است.

خروجی HTML ساده است - برچسب های معنایی برای سرفصل ها، پاراگراف ها، لیست ها، پیوندها و تصاویر، به علاوه قلاب های کلاس برای بلوک های کد جایی که ابزارهای برجسته سازی نحو انتظار آنها را دارند. خروجی به طور تمیز در هر CMS قرار می گیرد، در ژنراتورهای سایت استاتیک جاسازی می شود، یا به عنوان html. مستقل عمل می کند. هیچ CSS یا جاوا اسکریپتی اضافه نشده است. طراحی نتیجه به بافت پایین دست شما واگذار می شود.

چرا Markdown را به HTML تبدیل کنیم؟

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

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

نحوه استفاده

Markdown را بچسبانید، HTML دریافت کنید.

  1. Markdown خود را اضافه کنید: متن Markdown را در قسمت ورودی جای‌گذاری کنید یا یک فایل .md را رها کنید. هر دو ترکیب استاندارد Markdown و GitHub Flavored Markdown کار می کنند.
  2. تبدیل کنید: Marked Markdown را به یک AST تجزیه می کند و HTML را منتشر می کند. عناصر درون خطی استاندارد (تاکید، قوی، پیوندها، کد، تصاویر)، عناصر بلوک (عنوان، پاراگراف ها، لیست ها، نقل قول های بلوک)، و پسوندهای GFM (جدول، کد حصاردار، لیست وظایف، پیوندهای خودکار) همه به درستی ارائه می شوند.
  3. پیش نمایش: HTML ارائه شده را در پانل پیش نمایش بررسی کنید. تأیید کنید که بلوک‌های کد، جداول و سایر عناصر پیچیده همانطور که انتظار می‌رود ظاهر شوند.
  4. کپی یا دانلود کنید: HTML را برای چسباندن در CMS در کلیپ بورد کپی کنید، یا برای استفاده مستقل به صورت html ذخیره کنید. خروجی HTML5 معنایی بدون سبک های درون خطی است.

موارد استفاده رایج

جزئیات فنی

Marked از معماری دو گذری استفاده می کند. lexer ورودی را به توکن‌های سطح بلوک (عنوان، پاراگراف‌ها، فهرست‌ها، بلوک‌های کد) و توکن‌های درون خطی (تاکید، پیوندها، تصاویر) تبدیل می‌کند. تجزیه کننده جریان توکن را طی می کند و HTML را منتشر می کند و برای هر نوع توکن از قلاب های رندر استفاده می کند.

افزونه‌های Markdown با طعم GitHub به طور پیش‌فرض فعال هستند: جداول (با استفاده از نحو لوله‌ای)، بلوک‌های کد حصاردار (بک‌تیک‌های سه‌گانه با نکات زبان)، فهرست‌های کار (- [ ] و - [x])، خط خطی (با استفاده از tildes دوگانه)، و پیوند خودکار URL. بلوک های کد از قبل پیچیده شده در اطراف کد با کلاس زبان اختیاری برای برجسته کردن نحو پایین دست منتشر می کنند.

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

بهترین شیوه ها

سوالات متداول

آیا تبدیل MARKDOWN به HTML محتوا را تغییر می دهد؟
محتوا تا حد امکان دقیق حفظ می شود. با این حال، برخی از ویژگی های خاص قالب ممکن است معادل مستقیم نداشته باشند، بنابراین تفاوت های قالب بندی جزئی ممکن است رخ دهد.
فرمت HTML برای چه مواردی استفاده می شود؟
HTML (زبان نشانه گذاری HyperText) در درجه اول برای صفحات وب و محتوای وب استفاده می شود.
آیا محدودیتی وجود دارد که باید از آن آگاه بود؟
فایل های تا 50 مگابایت پشتیبانی می شوند. پردازش فایل های بسیار بزرگ یا پیچیده ممکن است بیشتر طول بکشد. تمام تبدیل ها در مرورگر شما انجام می شود، بنابراین سرعت پردازش به دستگاه شما بستگی دارد.
آیا این تبدیل امن و خصوصی است؟
بله. تمام پردازش ها به صورت محلی در مرورگر شما انجام می شود. داده‌های شما هرگز از دستگاه شما خارج نمی‌شوند - بدون آپلود سرور، بدون پردازش ابری، بدون جمع‌آوری داده‌ها.
آیا ایموجی ها پشتیبانی می شوند؟
ایموجی‌های یونیکد مستقیماً عبور می‌کنند (تایپ کردن یک شکلک قلب، قلب را در خروجی نشان می‌دهد). GitHub-style :emoji: کدهای کوتاه به طور پیش فرض تبدیل نمی شوند. در صورت نیاز یک افزونه اضافه کنید.
آیا Markdown من روی سرور آپلود می شود؟
خیر. اجراهای مشخص شده در مرورگر شما. تبدیل به طور کامل در دستگاه شما اتفاق می افتد.
آیا می توانم استایل سفارشی را به HTML اضافه کنم؟
بله بعد از تبدیل خروجی HTML معنایی ساده است. CSS خود را برای استایل سرفصل ها، بلوک های کد، جداول و سایر عناصر اعمال کنید.
آیا از پاورقی ها پشتیبانی می کند؟
CommonMark استاندارد نحو پاورقی را مشخص نمی کند. برخی از افزونه‌های Markdown از نحو پانوشت [^1] پشتیبانی می‌کنند. این مبدل از GFM پیروی می کند که شامل پاورقی نمی شود.