این ابزار درست کار نمی‌کند؟

دربارهٔ ابزار «مبدل Markdown به HTML آنلاین»

این ابزار Markdown را به HTML آماده انتشار تبدیل می‌کند. هدرها، تأکید، لیست‌ها، پیوندها، تصاویر، بلوک‌های کد، جداول، نقل قول‌ها، و کد inline همگی به عناصر HTML مناسب با نشانه‌گذاری معنایی رندر می‌شوند.

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

ابزار از CommonMark به‌علاوه رایج‌ترین افزونه‌های GitHub Flavored Markdown پشتیبانی می‌کند: جداول، خط خورده، فهرست‌های وظیفه، و بلوک‌های کد محصور با راهنمایی‌های syntax highlighting.

چطور از این ابزار استفاده کنم؟

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

  1. Markdown خود را بچسبانید

    محتوای .md خود را در فیلد «Markdown» قرار دهید. renderer از مبانی پشتیبانی می‌کند: headings (#–######)، bold/italic، inline code، fenced code، links و lists.

  2. چه چیزی پشتیبانی نمی‌شود

    این یک renderer حداقلی است، نه CommonMark کامل. جدول، footnote، task list، definition list، HTML سفارشی، GFM strikethrough و front-matter یا as-is عبور می‌کنند یا حذف می‌شوند — برای آن‌ها از ابزار سنگین‌تری استفاده کنید.

  3. «اجرا» را بزنید

    خروجی یک فیلد `html` است. renderer sanitise نمی‌کند — اگر به ورودی اعتماد دارید، اشکالی ندارد؛ اگر محتوای کاربر را embed می‌کنید، HTML را قبل از inject با sanitiser مثل DOMPurify عبور دهید.

  4. round-trip با html-to-markdown-converter

    Markdown → HTML → Markdown از طریق این دو ابزار لوسی است: سطوح header باقی می‌مانند، اما تو در تو quote، علامت‌های دقیق emphasis و سبک link reference یکسان برنمی‌گردند.