علامت گذاری به مبدل HTML
با پشتیبانی از پیش نمایش زنده، متن Markdown را به کد HTML آماده برای تولید تبدیل کنید.
با پشتیبانی از پیش نمایش زنده، متن Markdown را به کد HTML آماده برای تولید تبدیل کنید.
Markdown یک زبان نشانه گذاری سبک وزن است که توسط جان گروبر در سال 2004 ایجاد شد تا به نویسندگان اجازه دهد HTML ساختاریافته را با استفاده از قراردادهای متن ساده تولید کنند: کاراکترهای هش برای سرفصل ها، ستاره ها برای تأکید، خط فاصله برای لیست ها، بلوک های تورفتگی برای کد. این قالب به صورت پیشفرض برای فایلهای README، اسناد فنی، پیشنویسهای وبلاگ، تولیدکنندههای سایت استاتیک و هر زمینهای که نوشتهها باید به صورت متن ساده و خروجی رندر شده قابل خواندن باشد، تبدیل شده است. تبدیل Markdown به HTML مرحله رندر است که منبع را به یک صفحه وب تبدیل می کند.
این مبدل از کتابخانه علامتگذاری شده استفاده میکند، که بهطور گستردهترین رندر Markdown در جاوا اسکریپت مورد استفاده قرار میگیرد. Marked از CommonMark و GitHub Flavored Markdown (GFM) پشتیبانی میکند، که به معنای جداول، بلوکهای کد محصور شده، لیستهای وظایف، خطبندی و پیوند خودکار همه کارها به درستی علاوه بر ویژگیهای استاندارد Markdown است.
خروجی HTML ساده است - برچسب های معنایی برای سرفصل ها، پاراگراف ها، لیست ها، پیوندها و تصاویر، به علاوه قلاب های کلاس برای بلوک های کد جایی که ابزارهای برجسته سازی نحو انتظار آنها را دارند. خروجی به طور تمیز در هر CMS قرار می گیرد، در ژنراتورهای سایت استاتیک جاسازی می شود، یا به عنوان html. مستقل عمل می کند. هیچ CSS یا جاوا اسکریپتی اضافه نشده است. طراحی نتیجه به بافت پایین دست شما واگذار می شود.
Markdown قالبی است که نویسندگان و توسعه دهندگان ترجیح می دهند. HTML فرمتی است که مرورگرها ارائه می کنند. اکثر مولدهای سایت ایستا و پلتفرمهای CMS، Markdown را در پشت صحنه به HTML تبدیل میکنند، اما گاهی اوقات به تبدیل به عنوان یک مرحله مستقل نیاز دارید - چسباندن به یک CMS که پشتیبانی از Markdown ندارد، تولید HTML برای ایمیلها، تولید یک پیشنمایش سریع، یا استخراج خروجی رندر شده برای پردازش بیشتر.
HTML همچنین قالب متعارف برای هر محتوایی است که در نهایت در یک مرورگر نمایش داده می شود. خبرنامههای ایمیل ساخته شده از پیشنویسهای Markdown، صفحات مستندات تعبیهشده در برنامههای کاربردی HTML بزرگتر، و پستهای وبلاگی که در ویرایشگرهایی جایگذاری شدهاند که انتظار دارند HTML همگی از یک تبدیل تمیز بهره ببرند.
Markdown را بچسبانید، HTML دریافت کنید.
Marked از معماری دو گذری استفاده می کند. lexer ورودی را به توکنهای سطح بلوک (عنوان، پاراگرافها، فهرستها، بلوکهای کد) و توکنهای درون خطی (تاکید، پیوندها، تصاویر) تبدیل میکند. تجزیه کننده جریان توکن را طی می کند و HTML را منتشر می کند و برای هر نوع توکن از قلاب های رندر استفاده می کند.
افزونههای Markdown با طعم GitHub به طور پیشفرض فعال هستند: جداول (با استفاده از نحو لولهای)، بلوکهای کد حصاردار (بکتیکهای سهگانه با نکات زبان)، فهرستهای کار (- [ ] و - [x])، خط خطی (با استفاده از tildes دوگانه)، و پیوند خودکار URL. بلوک های کد از قبل پیچیده شده در اطراف کد با کلاس زبان اختیاری برای برجسته کردن نحو پایین دست منتشر می کنند.
پاکسازی خروجی به مصرف کنندگان پایین دست واگذار می شود. Marked هر آنچه را که ورودی تولید می کند منتشر می کند، از جمله HTML خام جاسازی شده در Markdown. اگر ورودی نامعتبر را میپذیرید، قبل از رندر کردن در مرورگر، خروجی را از طریق DOMPurify یا یک ضدعفونیکننده HTML مشابه اجرا کنید.