html به علامت گذاری

تبدیل HTML به Markdown به صورت آنلاین

قالب HTML یکی از قالب‌های اصلی برای وب‌سایت‌ها است زیرا اکثر مرورگرها از این استاندارد پشتیبانی می‌کنند. در حالی که یک فایل Markdown یک فایل متنی است که با استفاده از یکی از چندین گویش احتمالی زبان Markdown ایجاد شده است. از قالب‌بندی متن ساده استفاده می‌کند، اما حاوی نمادهای متنی درون خطی است که نحوه قالب‌بندی متن را مشخص می‌کند (مثلاً \bold\ برای متن پررنگ یا سایر نشانه‌گذاری‌ها برای ایتالیک، تورفتگی، سرصفحه و غیره). لطفاً توجه داشته باشید که فایل‌های Markdown ممکن است از پسوندهای MD، .MARKDN، و MDOWN. استفاده کنند که پسوندهای “.markdown” و “md.” محبوب‌ترین آنها هستند. بنابراین در این مقاله قصد داریم به جزئیات تبدیل HTML به Markdown با استفاده از REST API بپردازیم.

API تبدیل HTML به Markdown

Aspose.HTML Cloud یک API پیشرو در پردازش فایل های HTML است که قابلیت های دستکاری فایل های HTML را ارائه می دهد. همچنین از ویژگی تبدیل HTML به PDF، JPG، TIFF، XPS و سایر فرمت‌های پشتیبانی شده پشتیبانی می‌کند. همچنین از ویژگی تبدیل HTML به فرمت MD پشتیبانی می کند. اکنون برای توسعه مبدل HTML به markdown با استفاده از زبان جاوا، ابتدا باید Aspose.HTML Cloud SDK را برای مرجع جاوا در فایل pom.xml از نوع ساخت maven اضافه کنیم.

<repositories> 
    <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>http://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>

<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words-cloud</artifactId>
        <version>22.8.0</version>
    </dependency>
</dependencies>

پس از نصب، لطفاً یک حساب اشتراک رایگان در خدمات ابری ما از طریق Aspose.Cloud dashboard با استفاده از GitHub یا حساب Google ایجاد کنید. یا، به سادگی یک حساب جدید ایجاد کنید و جزئیات اعتبار مشتری خود را دریافت کنید.

HTML را به Markdown در جاوا تبدیل کنید

لطفاً دستورالعمل های مشخص شده در زیر را برای تبدیل HTML به Markdown دنبال کنید.

  • ابتدا، اعتبار کلاینت را در مقابل متدهای Configuration.setAPPSID و Configuration.setAPIKEY ارسال کنید.
  • در مرحله دوم، جزئیات را برای setBasePath (..)، setAuthPath (..) تنظیم کنید و setUserAgent (…) را به عنوان WebKit مشخص کنید.
  • ثالثاً به متد setDebug(..) true بفرستید.
  • پس از پیکربندی، لطفاً یک شی از کلاس ConversionApi ایجاد کنید.
  • در نهایت، روش PutConvertDocumentToMarkdown(…) را برای تبدیل HTML به Markdown و ذخیره خروجی در فضای ذخیره سازی ابری فراخوانی کنید.
// برای نمونه های بیشتر، لطفاً به https://github.com/aspose-html-cloud/aspose-html-cloud-java مراجعه کنید

try
    {
    // ClientID و ClientSecret را از https://dashboard.aspose.cloud/ دریافت کنید
    String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
    String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
  
    // جزئیات برای فراخوانی Api
    com.aspose.html.Configuration.setAPP_SID(clientId);
    com.aspose.html.Configuration.setAPI_KEY(clientSecret);
    com.aspose.html.Configuration.setBasePath("https://api.aspose.cloud/v3.0");
    com.aspose.html.Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
    com.aspose.html.Configuration.setUserAgent("WebKit");
    com.aspose.html.Configuration.setDebug(true);
        
    // یک شی از Aspose.HTML Cloud API ایجاد کنید
    com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
     	
    // سند html از فضای ذخیره سازی ابری
    String name = "list.html";
    	
    String folder = null; // The folder in the storage. Should exist.
    String storage = "Internal"; // Name of the storage. null
    	
    // اجرای تماس را آماده کنید
    retrofit2.Call<okhttp3.ResponseBody> call = htmlApi.PutConvertDocumentToMarkdown(name, "Converted.md", true, folder, storage);
      
    System.out.println("HTML to Markdown conversion sucessfull !");
    }catch(Exception ex)
    {
        System.out.println(ex);
    }

HTML به MD با استفاده از دستورات cURL

همانطور که Aspose.HTML Cloud مبتنی بر معماری REST است، بنابراین می توان به راحتی از طریق دستورات cURL به آن دسترسی داشت. اکنون، به عنوان یک پیش نیاز، باید توکن دسترسی JWT را بر اساس اعتبار مشتری مشخص شده در برابر حساب شما در داشبورد ابری ایجاد کنیم. اکنون، لطفا دستور زیر را برای تولید توکن JWT اجرا کنید:

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

هنگامی که توکن JWT را دریافت کردیم، لطفاً دستور زیر را برای HTML به MD اجرا کنید.

curl -v -X PUT "https://api.aspose.cloud/html/list.html/convert/md?outPath=Converted.md&useGit=false" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

نتیجه

این مقاله یک منبع عالی برای یادگیری مراحل توسعه مبدل HTML به Markdown با استفاده از Java Cloud SDK ارائه کرده است. مشاهده کردیم که با خطوط کد کمتر، موفق شدیم HTML را به فرمت MD تبدیل کنیم. همچنین می‌توانید APIها را از طریق Swagger UI در یک مرورگر وب بررسی کنید. اگر سؤالات مرتبطی دارید یا با مشکلی مواجه شدید، لطفاً از طریق [تالار گفتمان پشتیبانی فنی] رایگان با ما تماس بگیرید.

مقالات مرتبط

برای کسب اطلاعات بیشتر در مورد آنها به شدت توصیه می کنیم مقالات زیر را مرور کنید: