نحوه تبدیل HTML به Markdown
- یک قطعه HTML را جایگذاری کرده یا یک فایل
.htmlپشتیبانیشده را بارگذاری کنید. - کد منبع را تبدیل کرده و بررسی کنید کدام عناصر معنایی در Markdown همچنان معنادار هستند.
- لینکها، تصاویر، لیستهای تودرتو، جدولها و حصارهای کد را تبدیل و بررسی کنید.
- کد Markdown را کپی کرده یا فایل
.mdرا دانلود کنید.
مبدل چه مواردی را حفظ میکند؟
| محتوای منبع | رفتار خروجی توصیهشده | یادداشت تبدیل |
|---|---|---|
| عنوانها | نگاشت <h1>–<h6> به عنوانهای Markdown | |
| پاراگرافها و برجستهسازی | تبدیل پاراگرافها، موارد پررنگ و برجسته | |
| لیستها | تبدیل لیستهای مرتب، نامرتب و تودرتو | |
| لینکها | حفظ متن و URL حلشده | |
| تصاویر | حفظ منبع و متن جایگزین (alt) | |
| کد | استفاده از کد درونخطی و بلوکهای حصاردار | |
| جدولها | تبدیل جدولهای سازگار به GFM | |
| نقلقولها (Blockquotes) | تبدیل نقلقولهای معنایی |
چه مواردی ممکن است در طول تبدیل تغییر کند؟
اسکریپتها، استایلها و فرمها
عناصر اجرایی و تعاملی معادل معمولی در Markdown ندارند و ممکن است حذف شوند یا به متن ساده کاهش یابند.
جدولهای پیچیده
ادغام سطرها (rowspans)، ادغام ستونها (colspans)، جدولهای تودرتو و محتوای غنی سلولها ممکن است نیاز به HTML خام یا تختسازی داشته باشد.
آدرسهای URL نسبی
یک قطعه جایگذاریشده ممکن است شامل آدرس URL پایهای صفحه نباشد، بنابراین لینکهای نسبی و مسیرهای تصاویر همیشه قابل حل نیستند.
کانتینرهای چیدمان
چیدمانهای div، گرید و flexbox ترتیب خوانش معنایی خاصی را نشان نمیدهند.
محتوای پنهان و الگو
مبدل نیاز به سیاست روشنی برای عناصر پنهان، ناوبری و محتوای از نظر بصری جمعشده دارد.
کاربردهای رایج HTML به Markdown
انتقال مستندات وب
انتقال HTML معنایی به یک سیستم مستندسازی مبتنی بر Markdown.
پاکسازی متنهای غنی کپیشده
تبدیل HTML تولیدشده توسط ویرایشگر به قالبی سادهتر قبل از نسخهگذاری یا انتشار.
آمادهسازی نمونههای کد
حفظ بلوکهای کد و عنوانها بدون انتقال استایلشیت کامل صفحه.
ایجاد بافت هوش مصنوعی متمرکز بر متن
حذف اسکریپتها و استایلها با حفظ ساختار اطلاعاتی که همچنان باید بررسی شود.
نمونه تبدیل HTML به Markdown
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>## Setup
Read the [guide](/guide).
- Install
- Testنکاتی برای خروجی تمیزتر Markdown
- استفاده از HTML معنایی عنوانها، لیستها و جدولها بسیار مطمئنتر از کانتینرهای چیدمان عمومی تبدیل میشوند.
- ارائه آدرس URL پایه در صورت نیاز اگر خروجی باید خارج از صفحه اصلی کار کند، لینکهای نسبی نیاز به بافت دارند.
- انتخاب گویش خروجی قالب GFM از جدولها و لیستهای وظیفه پشتیبانی میکند که CommonMark پایه آنها را تعریف نمیکند.
- بررسی حصارهای کد تایید زبان برنامهنویسی شناساییشده و هرگونه علامت بکتیک جاسازیشده.
- تصمیمگیری در مورد جایگزین HTML خام نگه داشتن کدهای HTML پشتیبانینشده ممکن است اطلاعات را حفظ کند اما قابلیت حمل را کاهش میدهد.
پرسشهای متداول
آیا عناصر <script> و <style> حذف میشوند؟
اسکریپتها و استایلها محتوای مفیدی در Markdown نیستند و در نتیجه نباید به آنها تکیه کرد. پیش از استفاده مجدد از خروجی، HTML جایگذاریشده را بررسی کنید.
آیا جدولهای HTML به جدولهای Markdown تبدیل میشوند؟
جدولهای مستطیلی سازگار میتوانند به جدولهای GFM تبدیل شوند. جدولهای دارای rowspan، colspan، بلوکهای تودرتو یا چند سطر هدر به یک جایگزین مستند نیاز دارند.
آیا بلوکهای کد و کدهای درونخطی حفظ میشوند؟
آنها میتوانند از تگهای <pre> و <code> نگاشت شوند.
چه اتفاقی برای لینکها و تصاویر میافتد؟
متن لینک و مقصدهای معتبر ممکن است حفظ شوند. لینکهای نسبی و مسیرهای تصاویر همچنان به بافت وابستهاند زیرا یک قطعه بارگذاریشده آدرس URL پایه تضمینشدهای ندارد.
آیا تگهای HTML پشتیبانینشده حذف میشوند یا حفظ میشوند؟
کاورهای صرفاً بصری ممکن است سادهسازی شوند در حالی که متن خوانا حفظ میشود. در مواردی که عناصر سفارشی معنایی دارند، خروجی را با منبع مقایسه کنید.
آیا مبدل خروجی CommonMark میدهد یا GFM؟
خروجی مورد نظر GitHub-Flavored Markdown است. جدولها، خط زدن روی متن و لیستهای وظیفه به افزونههای GFM متکی هستند.
آیا میتوانم یک سند کامل HTML را جایگذاری کنم؟
بله. میتوانید یک قطعه را جایگذاری کنید یا یک فایل .html یا .htm را بارگذاری کنید، سپس Markdown تولیدشده را بررسی کنید.
آیا این صفحه میتواند آدرس URL یک وبسایت زنده را تبدیل کند؟
خیر. این صفحه فقط کدهای HTML جایگذاریشده یا فایل HTML بارگذاریشده را میپذیرد؛ و آدرس URL یک وبسایت زنده را واکشی نمیکند.
تبدیل مجدد Markdown به PDF
از قبل فایل Markdown دارید؟ برای ایجاد یک PDF قابل اشتراکگذاری ازمبدل Markdown به PDFاستفاده کنید.