Конвертировать HTML в Markdown – Aspose.HTML Cloud SDK

Markdown – это язык разметки, известный своим синтаксисом форматирования простого текста. Благодаря удобочитаемости и простоте написания он обычно используется для документации и файлов README. Первоначально предназначенный для преобразования в HTML, универсальность Markdown теперь распространяется на различные форматы вывода. Облако Aspose.HTML предлагает уникальную функцию: преобразование HTML обратно в Markdown. Эта функция позволяет пользователям легко получать доступ, редактировать или создавать файлы Markdown с любого устройства с помощью любого текстового редактора, повышая гибкость и простоту управления контентом.

Aspose.HTML Cloud предоставляет простейший API SDK для преобразования документов HTML в формат Markdown с высоким качеством, просто и быстро. Эта статья содержит набор примеров кода, объясняющих, как преобразовать HTML в Markdown с помощью доступных SDK.

Примеры преобразования HTML в Markdown

Aspose.HTML Cloud SDK позволяет вам получить HTML-документ из места хранения по его имени, из URL-адреса или локального файла на вашем диске, преобразовать его в указанный формат и сохранить результат в хранилище или на локальном диске. В следующих примерах кода показано, как программно преобразовать HTML в Markdown для различных случаев.

Пример 1. Преобразование HTML в Markdown с параметрами сохранения по умолчанию

Рассмотрим пример преобразования локального HTML-файла в Markdown и сохранения результата по локальному пути.

В следующем примере показан самый простой способ преобразования HTML в Markdown с применением языка C#. Вы можете скачать C# SDK из репозитория GitHub.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert from HTML file to Markdown file
5var result = await api.ConvertAsync("test.html", "test.md");

Java

В следующем примере показано, как преобразовать HTML в Markdown с применением языка Java. Вы можете загрузить Java SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.html")
 8                .saveToLocal("output.md");
 9
10OperationResult result = api.convert(builder);

C++

В следующем примере показано, как преобразовать HTML в Markdown с применением языка C++. Локальный HTML-код преобразуется в Markdown и сохраняется по локальному пути.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = w_cur_dir + L"test.html";
23utility::string_t dst = w_cur_dir + L"result.md";
24
25//Conversion
26auto result = api->convertLocalToLocal(src, dst);
27
28// Check the result file
29auto re = result->getFile();
30std::ifstream f(re.c_str());
31if(!f.good())
32{
33    throw std::runtime_error("Conversion failed");
34}

Python

В следующем примере показано, как преобразовать HTML в Markdown на Python. Вы можете скачать Python SDK из репозитория GitHub.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.convertApi.convert_local_to_local(input_file="test.html", output_file="test.md")
16except ApiException as ex:
17    print("Exception")
18    print("Info: " + str(ex))
19    raise ex

PHP

В следующем примере показано, как преобразовать HTML в Markdown с применением языка PHP. Вы можете скачать PHP SDK из репозитория GitHub.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'input.html';
15$dst = 'output.md';
16
17try {
18    // Request to server Api
19    $result = $api_html->convertLocalToLocal($src, $dst);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
23}
24
25?>

Ruby

В следующем примере показано, как преобразовать HTML в Markdown на Ruby. Вы можете скачать Ruby SDK из репозитория GitHub.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8CONFIG = {
 9    "basePath":"https://api.aspose.cloud/v4.0",
10    "authPath":"https://api.aspose.cloud/connect/token",
11    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
12    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
13    "debug":true
14}
15
16api_instance = AsposeHtml::HtmlApi.new CONFIG
17
18src = "test.html"  # String | Full path to the input file.
19dst = "test.md"    # String | Full path to the result.
20
21begin
22  #Convert the document from the local file and save result to the local file.
23  result = api_instance.convert_local_to_local(src, dst)
24  p result
25rescue AsposeHtml::ApiError => e
26  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
27end

Node.js

В следующем примере показано, как преобразовать HTML в Markdown на Node.js. Локальный HTML-код преобразуется в Markdown и сохраняется по локальному пути.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "/path/to/src/test.html"; // {String} Source document.
19var dst = "/path/to/dst/test.md";  // {String} Result document.
20var opts = null;
21
22var callback = function(error, data, response) {
23  if (error) {
24    console.error(error);
25  } else {
26    console.log(data);
27  }
28};
29
30conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

В следующем примере показано, как преобразовать HTML в Markdown на Swift. Вы можете скачать Swift SDK из репозитория GitHub.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resourceDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/Resources")
 8let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 9
10func url(forResource fileName: String) -> URL {
11	return resourceDir.appendingPathComponent(fileName)
12}
13
14func fileExist(name: String) -> Bool {
15	return FileManager.default.fileExists(atPath: name)
16}
17
18ClientAPI.setConfig(
19	basePath: "https://api.aspose.cloud/v4.0",
20	authPath: "https://api.aspose.cloud/connect/token",
21	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
22	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
23	debugging: true
24)
25
26let fileName = "test.html"
27let format = "md"
28let src = url(forResource: fileName).absoluteString
29
30let expectation = self.expectation(description: "testConvert to \(format)")
31let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
32HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: nil) { (data, error) in
33
34	guard error == nil else {
35		XCTFail("Error convert html to \(format)). Error=\(error!.localizedDescription)")
36		return
37	}
38	let resultPath = data!.file!
39	XCTAssertTrue(fileExist(name: resultPath))
40	expectation.fulfill()
41}
42self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

В следующем примере показано, как преобразовать HTML в Markdown с помощью Java/Android. Вы можете загрузить Java/Android SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.html")
 8                .saveToLocal("output.md");
 9
10OperationResult result = api.convert(builder);

CURL

Загрузите локальный файл в хранилище с помощью Storage API.
Вызовите REST API для выполнения преобразования (в примере ниже).
Загрузите результат преобразования обратно из хранилища с помощью Storage API.

В следующем примере показано, как преобразовать HTML в Markdown с применением REST API. Выполните несколько обязательных шагов:

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/html-md" \
3    -d "{'InputPath': '/testpage.html', 'OutputFile': 'test.md'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Пример 2. Преобразование веб-страницы в Markdown

Aspose.HTML Cloud позволяет вам получить веб-страницу по ее URL-адресу, преобразовать ее в другой формат и сохранить в локальную файловую систему. В приведенном ниже примере показано, как преобразовать веб-страницу в Markdown с параметрами преобразования по умолчанию.

В следующем примере показано, как преобразовать веб-страницу в Markdown с применением языка C#. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете скачать C# SDK из репозитория GitHub.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert HTML to Markdown using ConvertUrlAsync() method
5var result = await api.ConvertUrlAsync("https://example.com", "test.md");

Java

В следующем примере показано, как преобразовать веб-страницу в Markdown с применением языка Java. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете загрузить Java SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromUrl("https://example.com")
 8                .saveToLocal("output.md");
 9
10OperationResult result = api.convert(builder);

C++

В следующем примере показано, как преобразовать веб-страницу в язык Markdown C++. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = L"https://example.com";
23utility::string_t dst = w_cur_dir + L"result.md";
24
25//Conversion
26auto result = api->convertUrlToLocal(src, dst);
27
28// Check the result file
29auto re = result->getFile();
30std::ifstream f(re.c_str());
31if(!f.good())
32{
33    throw std::runtime_error("Conversion failed");
34}

Python

В следующем примере показано, как преобразовать веб-страницу в Markdown на Python. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете скачать Python SDK из репозитория GitHub.

 1import os
 2from asposehtmlcloud.configuration import Configuration
 3from asposehtmlcloud.api.html_api import HtmlApi
 4from asposehtmlcloud.api_client import ApiClient as Client
 5from asposehtmlcloud.rest import ApiException
 6
 7# Get keys from aspose site.
 8# There is free quota available. 
 9# For more details, see https://purchase.aspose.cloud/pricing
10
11configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
12                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
13                              basePath="https://api.aspose.cloud/v4.0",
14                              authPath="https://api.aspose.cloud/connect/token",
15                              debug=True)
16
17client = Client(configuration)
18html_api = HtmlApi(client)
19
20try:
21    res = html_api.convert_url_to_local(input_file="https://example.com", output_file="result.md")
22    if not os.path.exists(res.file):
23        print('conversion failed')
24except ApiException as ex:
25    print("Exception")
26    print("Info: " + str(ex))
27    raise ex

PHP

В следующем примере показано, как преобразовать веб-страницу в Markdown с применением языка PHP. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете скачать PHP SDK из репозитория GitHub.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'https://example.com';
15$dst = 'output.md';
16
17try {
18    // Request to server Api
19    $result = $api_html->convertUrlToLocal($src, $dst);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling HtmlApi->convertUrlToLocal: ', $e->getMessage(), PHP_EOL;
23}
24?>

Ruby

В следующем примере показано, как преобразовать веб-страницу в Markdown на Ruby. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете скачать Ruby SDK из репозитория GitHub.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8
 9CONFIG = {
10    "basePath":"https://api.aspose.cloud/v4.0",
11    "authPath":"https://api.aspose.cloud/connect/token",
12    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
13    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
14    "debug":true
15}
16
17api_instance = AsposeHtml::HtmlApi.new CONFIG
18
19src = "https://example.com"  # String | Input url.
20dst = "test.md"              # String | Result file.
21
22begin
23  #Convert the HTML file from the web and save result to the local file.
24  result = api_instance.convert_url_to_local(src, dst)
25  p result
26rescue AsposeHtml::ApiError => e
27  puts "Exception when calling api_instance.convert_url_to_local: #{e}"
28end

Node.js

В следующем примере показано, как преобразовать веб-страницу в Markdown с применением языка Node.js. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "https://example.com";   // {String} Url for conversion.
19var dst = "/path/to/dst/test.md"; // {String} Result document.
20var opts = null;
21
22var callback = function(error, data, response) {
23  if (error) {
24    console.error(error);
25  } else {
26    console.log(data);
27  }
28};
29
30conversionApi.convertUrlToLocal(src, dst, opts, callback);

Swift

В следующем примере показано, как преобразовать веб-страницу в Markdown на Swift. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете скачать Swift SDK из репозитория GitHub.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 8
 9func fileExist(name: String) -> Bool {
10	return FileManager.default.fileExists(atPath: name)
11}
12
13ClientAPI.setConfig(
14	basePath: "https://api.aspose.cloud/v4.0",
15	authPath: "https://api.aspose.cloud/connect/token",
16	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
17	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
18	debugging: true
19)
20
21let format = "md"
22let src = "https://example.com"
23let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
24
25let expectation = self.expectation(description: "testConvert to \(format)")
26
27HtmlAPI.convertUrlToLocal(src: src, dst: dst, options: nil) { (data, error) in
28
29	guard error == nil else {
30		XCTFail("Error convert web site to \(format)). Error=\(error!.localizedDescription)")
31		return
32	}
33	let resultPath = data!.file!
34	XCTAssertTrue(fileExist(name: resultPath))
35	expectation.fulfill()
36}
37self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

В следующем примере показано, как преобразовать веб-страницу в Markdown с применением Java/Android. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Вы можете загрузить Java/Android SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromUrl("https://example.com")
 8                .saveToLocal("output.md");
 9
10OperationResult result = api.convert(builder);

CURL

Вызовите REST API для выполнения преобразования (в примере ниже).
Загрузите результат преобразования обратно из хранилища с помощью Storage API.

В следующем примере показано, как преобразовать веб-страницу в Markdown с помощью REST API. HTML берется из Интернета, конвертируется в Markdown и сохраняется в локальной файловой системе. Выполните несколько обязательных шагов:

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/html-md" \
3    -d "{'InputPath': 'https://example.com', 'OutputFile': 'test.md'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Преобразование HTML в Markdown происходит с использованием параметров преобразования по умолчанию: ширина и высота результирующего документа MD соответствуют формату A4, а все поля имеют нулевое значение.

Пример 3. Преобразование HTML в Markdown внутри облачного хранилища

Aspose.HTML Cloud позволяет получить HTML-файл из облачного хранилища и сохранить результат преобразования обратно в облачное хранилище.

В следующем примере показано, как преобразовать HTML в Markdown на C#. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете скачать C# SDK из репозитория GitHub.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert HTML to Markdown
5var builder = new ConverterBuilder()
6                .FromStorageFile("/test.html")
7                .ToStorageFile("/test.md");
8                
9var result = await api.ConvertAsync(builder);

Java

В следующем примере показано, как преобразовать HTML в Markdown с применением языка Java. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете загрузить Java SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromStorageFile("input.html")
 8                .saveToStorage("output.md");
 9
10OperationResult result = api.convert(builder);

C++

В следующем примере показано, как преобразовать HTML в Markdown на C++. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище.

 1const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 2const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 3const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
 4const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
 5
 6// Create configuration for authorization
 7std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
 8
 9// Create client from configuration
10std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
11
12// Create ConversionApi
13std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
14
15// File name for conversion
16utility::string_t src = L"file/in/storage/index.html";
17utility::string_t dst = L"result/in/storage/result.md";
18
19//Conversion
20auto result = api->convertStorageToStorage(src, dst);

Python

В следующем примере показано, как преобразовать HTML в Markdown на Python. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете скачать Python SDK из репозитория GitHub.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.convertApi.convert_storage_to_storage(input_file="test.html", output_file="test.md",
16                                                         storage_name=None)
17except ApiException as ex:
18    print("Exception")
19    print("Info: " + str(ex))
20    raise ex

PHP

В следующем примере показано, как преобразовать HTML в Markdown с помощью PHP. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете скачать PHP SDK из репозитория GitHub.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$configuration = array(
 5    "basePath" => "https://api.aspose.cloud/v4.0",
 6    "authPath" => "https://api.aspose.cloud/connect/token",
 7    "apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8    "appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9    "defaultUserAgent" => "Webkit"
10);
11
12$api_html = new HtmlApi($configuration);
13
14$src = "FolderInStorage/test.html";
15$dst = 'FolderInStorage/test.md';
16$options = null;
17
18try {
19    $result = $api_html->convertStorageToStorage($src, $dst, null, $options);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling $api_html->convertStorageToStorage: ', $e->getMessage(), PHP_EOL;
23}
24?>

Ruby

В следующем примере показано, как преобразовать HTML в Markdown на Ruby. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете скачать Ruby SDK из репозитория GitHub.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8
 9CONFIG = {
10    "basePath":"https://api.aspose.cloud/v4.0",
11    "authPath":"https://api.aspose.cloud/connect/token",
12    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
13    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
14    "debug":true
15}
16
17api_instance = AsposeHtml::HtmlApi.new CONFIG
18
19src = "FolderInStorage/test.html" # String | Source file.
20dst = "FolderInStorage/test.md"   # String | Result file.
21storage = nil
22
23begin
24  #Convert the file from the storage and save result to the storage.
25  result = api_instance.convert_storage_to_storage(src, dst, storage)
26  p result
27rescue AsposeHtml::ApiError => e
28  puts "Exception when calling api_instance.convert_storage_to_storage: #{e}"
29end

Node.js

В следующем примере показано, как преобразовать HTML в Markdown на Node.js. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "FolderInStorage/test.html"; // {String} Source document.
19var dst = "FolderInStorage/test.md";  // {String} Result document.
20var opts = null;
21var storage = null;
22
23var callback = function(error, data, response) {
24  if (error) {
25    console.error(error);
26  } else {
27    console.log(data);
28  }
29};
30
31conversionApi.convertStorageToStorage(src, dst, storage, opts, callback);

Swift

В следующем примере показано, как преобразовать HTML в Markdown на Swift. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете скачать Swift SDK из репозитория GitHub.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6ClientAPI.setConfig(
 7	basePath: "https://api.aspose.cloud/v4.0",
 8	authPath: "https://api.aspose.cloud/connect/token",
 9	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
10	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
11	debugging: true
12)
13
14let src = "FolderInStorage/test.html"
15let dst = "FolderInStorage/test.md"
16
17let expectation = self.expectation(description: "testConvert to md")
18
19HtmlAPI.convertStorageToStorage(src: src, dst: dst, storage: nil, options: nil) { (data, error) in
20
21    guard error == nil else {
22        XCTFail("Error convert html to md. Error=\(error!.localizedDescription)")
23        return
24    }
25
26    let resultPath = data!.file!
27
28    StorageAPI.objectExists(path: resultPath, storageName: nil, versionId: nil) {(data, error) in
29        guard error == nil else {
30            XCTFail("Error objectExists exist. Error=\(error!.localizedDescription)")
31            return
32        }
33
34        XCTAssertTrue(data!.exists)
35        XCTAssertFalse(data!.isFolder)
36        expectation.fulfill()
37    }
38}
39self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

В следующем примере показано, как преобразовать HTML в Markdown с помощью Java/Android. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище. Вы можете загрузить Java/Android SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromStorageFile("input.html")
 8                .saveToStorage("output.md");
 9
10OperationResult result = api.convert(builder);

CURL

В следующем примере показано, как преобразовать HTML в Markdown с помощью REST API. HTML-файл находится в облачном хранилище, конвертируется в Markdown и сохраняется обратно в облачное хранилище.

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/html-md" \
3    -d "{'InputPath': '/test.html', 'OutputFile': '/test.md'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Смотрите также

Статья Доступные SDK знакомит вас с возможностями Aspose.HTML Cloud использовать SDK на различных языках программирования, таких как C#, Java, Python, Ruby, PHP, Node.js, Swift, Android и C++.
В статье Параметры конвертации описан набор классов, представляющих параметры преобразования исходного документа на основе HTML в PDF, XPS и изображения.
Облачный API Aspose.HTML можно вызвать непосредственно из браузера, открыв Справочник по API.
Aspose.HTML предлагает бесплатный онлайн HTML в Markdown Конвертер, который конвертирует HTML в MD с высоким качеством, легкостью и скоростью. Просто загрузите файлы, конвертируйте их и получите результат через несколько секунд!

Конвертировать HTML в MHTML EPUB Конвертер