تبدیل Markdown به HTML
Markdown را با پیشنمایش زنده به HTML تبدیل کنید یا HTML را به Markdown تمیز برگردانید، با پشتیبانی از جدولها و بلوکهای کد.
تبدیل Markdown به HTML - و برگرداندن HTML به Markdown
Markdown بنویسید یا بچسبانید و آن را همزمان با تایپ رندرشده ببینید، در حالی که HTML پشت آن فقط یک کلیک فاصله دارد. یا برعکس: HTML یک صفحهٔ وب، یک CMS یا یک ایمیل را بچسبانید و برای یک README، یک ویکی یا یک سایت ایستا Markdown تمیز بگیرید. جدولها، فهرست کارها، خطخوردگی و بلوکهای کد حصاردار از GitHub Flavored Markdown در هر دو جهت کار می‌کنند و همه‌چیز در مرورگر شما اجرا میشود.
Markdown زبانی است که برنامه‌نویس‌ها با آن مستندات می‌نویسند، بسیاری از برنامه‌های یادداشت‌برداری متن را با آن ذخیره می‌کنند و GitHub، GitLab و Stack Overflow نوشته‌ها را با آن قالب‌بندی می‌کنند. HTML چیزی است که مرورگر لازم دارد. تبدیل دستی این دو به هم خسته‌کننده است و خطا در آن آسان.
روش استفاده
- Markdown → HTML یا HTML → Markdown را انتخاب کنید.
- متن خود را تایپ کنید یا بچسبانید؛ نتیجه همزمان با تایپ به‌روز میشود.
- برای Markdown، میان پیشنمایش و HTML جابه‌جا شوید؛ برای گرفتن یک سند کامل، صفحهٔ کامل HTML را تیک بزنید.
- کپی یا دانلود را بزنید. با عوض کردن جهت، نتیجه هم منتقل میشود، پس می‌توانید رفت‌وبرگشتی تبدیل کنید.
نحو Markdown در یک نگاه
| Markdown | نتیجه |
|---|---|
# Title، ## Section | سرتیترهای سطح ۱ و ۲ |
**bold**، *italic*، ~~struck~~ | پررنگ، کج، خط‌خورده |
[text](https://example.com) | یک پیوند |
 | یک تصویر |
- item یا 1. item | فهرست نشانه‌دار یا شماره‌دار |
- [x] done | یک مورد از فهرست کارها |
`code` و بلوکهای حصاردار با ``` | کد درون‌خطی و بلوک کد |
ردیف‌های | a | b | با یک خط |---| | یک جدول |
> quote | یک نقل‌قول بلوکی |
شکستن خط
در Markdown استاندارد، یک شکستن خط تکی درون پاراگراف نادیده گرفته میشود؛ برای شروع پاراگراف تازه یک خط خالی لازم است، یا برای شکستن خط باید دو فاصله در انتهای خط بگذارید. بسیاری انتظار دارند هر شکستن خط دیده شود، چون دیدگاههای GitHub همین‌طور رفتار می‌کنند. برای این رفتار، حفظ شکستن خطهای تکی را تیک بزنید.
تبدیل HTML به Markdown
با چسباندن HTML، سرتیترها، پاراگراف‌ها، پیوندها، تصویرها، فهرست‌ها، جدولها، نقل‌قول‌های بلوکی و بلوکهای کد به معادل Markdown خود تبدیل میشوند. اسکریپت‌ها، استایل‌ها و هر چیزی که Markdown نمیتواند بیانش کند، مثل رنگ‌ها یا چیدمان، کنار گذاشته میشوند؛ وقتی محتوا را به یک README یا سایت مستندات منتقل می‌کنید معمولاً همین را می‌خواهید. می‌توانید میان سرتیترهای با علامت # و زیرخط‌دار یکی را برگزینید و نشانهٔ فهرست را انتخاب کنید.
امنیت
Markdown می‌تواند HTML خام، از جمله اسکریپت، داشته باشد. پیشنمایش در یک قاب ایزوله (sandbox) نمایش داده میشود که اسکریپت در آن اجرا نمیشود و به این صفحه دسترسی ندارد، پس سندی که می‌چسبانید نمیتواند اینجا آسیبی بزند. با این حال خروجی HTML پاکسازی نمیشود: اگر Markdown از کسی آمده که به او اعتماد ندارید، پیش از انتشار HTML روی یک وبسایت، آن را پاکسازی کنید.
ابزارهای مرتبط
برای تورفتگی دادن یا فشرده کردن HTML به‌دست‌آمده، از فرمت‌کنندهٔ کد استفاده کنید. برای شمردن کلمه‌های سندتان، از شمارندهٔ کلمات استفاده کنید. صفحه‌های کاربردی این ابزار را روی یک کار مشخص باز می‌کنند: تبدیل HTML به Markdown و پیشنمایش Markdown.