Convertir Markdown a PDF – Cloud SDK y API REST

Markdown a PDF

PDF es un formato de documento estático que admite texto, imágenes, campos de formulario, medios, firmas digitales, hipervínculos, etc. La conversión de Markdown a PDF conserva el formato del documento y garantiza una visualización coherente en diferentes dispositivos y plataformas. PDF es ampliamente compatible y proporciona un formato confiable para compartir y archivar documentos manteniendo el diseño y el estilo originales del contenido de Markdown. Las amplias funciones de interoperabilidad y seguridad de los archivos PDF mejoran el intercambio de documentos y la protección de información confidencial.

Aspose.HTML Cloud v4.0 proporciona la API más sencilla para convertir documentos MD al formato PDF con alta calidad, fácil y rápido.

El artículo detalla una serie de ejemplos de código que demuestran la conversión de un documento Markdown a PDF utilizando los SDK del cliente Aspose.HTML Cloud y la API REST. Los SDK están disponibles en PHP, C++, Python, C#, Ruby, Java, Android, Swift y Node.js. Se cubren varios escenarios de conversión:

Convertir un archivo Markdown local a PDF y guardar el resultado en el sistema de archivos local. Esto incluye explorar conversiones con parámetros predeterminados y especificados explícitamente.
Convertir Markdown a PDF directamente en el almacenamiento en la nube utilizando los parámetros de conversión predeterminados.

Ejemplos de conversión de Markdown a PDF

Un caso de uso común de las funciones de Aspose.HTML Cloud SDK es el procesamiento y la conversión de archivos. El SDK de Cloud le permite recuperar un documento Markdown del almacenamiento por su nombre o de un archivo local en su disco, convertirlo a un formato específico y guardarlo nuevamente en el almacenamiento o en su disco local. Los siguientes ejemplos de código demuestran cómo convertir Markdown a PDF utilizando varios SDK y cURL para diferentes escenarios.

Ejemplo 1. Convertir Markdown a PDF con opciones de guardado predeterminadas

Veamos un ejemplo de cómo convertir un archivo Markdown local a PDF y guardar el resultado en un sistema de archivos local. La conversión se produce con las opciones de conversión predeterminadas.

El siguiente ejemplo demuestra la forma más sencilla de convertir Markdown a PDF usando C#. Puede descargar el SDK de C# desde el repositorio de GitHub.

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

Java

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando Java. Puede descargar el SDK de Java desde el repositorio de 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.md")
 8                .saveToLocal("output.pdf");
 9
10OperationResult result = api.convert(builder);

C++

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje C++. Markdown local convertido a PDF y guardado en la ruta local.

 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.md";
23utility::string_t dst = w_cur_dir + L"result.pdf";
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

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Python. Puede descargar el SDK de Python desde el repositorio de 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.md", output_file="test.pdf")
16except ApiException as ex:
17    print("Exception")
18    print("Info: " + str(ex))
19    raise ex

PHP

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando PHP. Puede descargar el SDK de PHP desde el repositorio de 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.md';
15$dst = 'output.pdf';
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

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Ruby. Puede descargar el SDK de Ruby desde el repositorio de 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.md"  # String | Full path to the input file.
19dst = "test.pdf"   # 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

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Node.js. Markdown local convertido a PDF y guardado en la ruta local.

 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.md"; // {String} Source document.
19var dst = "/path/to/dst/test.pdf"; // {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

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Swift. Puede descargar el SDK de Swift desde el repositorio de 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.md"
27let format = "pdf"
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 Markdown 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

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando Java/Android. Puede descargar el SDK de Java/Android desde el repositorio de 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.md")
 8                .saveToLocal("output.pdf");
 9
10OperationResult result = api.convert(builder);

CURL

Cargue un archivo local al almacenamiento usando API de almacenamiento.
Llame a la API REST para ejecutar la conversión (en el ejemplo siguiente).
Descargue el resultado de la conversión desde el almacenamiento usando API de almacenamiento.

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando la API REST. Siga algunos pasos requeridos:

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

La conversión de Markdown a PDF se produce con las opciones de conversión predeterminadas: el ancho y el alto del documento PDF resultante corresponden a A4, y todos los márgenes tienen valor cero.

Ejemplo 2. Convertir Markdown a PDF con opciones especificadas explícitamente

El siguiente ejemplo demuestra cómo convertir un archivo Markdown de un sistema de archivos local a PDF con opciones especificadas explícitamente y guardar el resultado en el sistema de archivos local.

El siguiente ejemplo de SDK demuestra cómo convertir Markdown a PDF usando C#. Puede descargar el SDK de C# desde el repositorio de GitHub.

 1// Initialize SDK API
 2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
 3
 4// Create an options object and specify options for Markdown to PDF conversion
 5var options = new PDFConversionOptions()
 6                .SetHeight(8.3)
 7                .SetWidth(11.7)
 8                .SetLeftMargin(0.5)
 9                .SetRightMargin(0.5)
10                .SetBottomMargin(0.5)
11                .SetTopMargin(0.5);
12
13// Convert Markdown file to PDF format
14var result = await api.ConvertAsync("test.md", "test.pdf", options);

Java

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando Java. Puede descargar el SDK de Java desde el repositorio de 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
 6PDFConversionOptions opt_A5 = new PDFConversionOptions()
 7                    .setWidth(5.8)        // A5 format in inches
 8                    .setHeight(8.3)
 9                    .setTopMargin(0.5)
10                    .setBottomMargin(0.5)
11                    .setLeftMargin(0.5)
12                    .setRightMargin(0.5)
13                    .setQuality(95);
14
15JobBuilder builder = new ConverterBuilder()
16                .fromLocalFile("input.md")
17                .useOptions(opt_A5)
18                .saveToLocal("output.pdf");
19
20OperationResult result = api.convert(builder);

C++

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando C++. Markdown se toma de un sistema de archivos local, se convierte a PDF y se guarda en la unidad local.

 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.md";
23utility::string_t dst = w_cur_dir + L"result.pdf";
24
25std::shared_ptr<ConversionOptions> opts = std::make_shared<ConversionOptions>();
26opts->setWidth(8.3)
27    ->setHeight(11.7)
28    ->setLeftMargin(0.2)
29    ->setRightMargin(0.2)
30    ->setTopMargin(0.2)
31    ->setBottomMargin(0.2);
32
33// Conversion
34auto result = api->convertLocalToLocal(src, dst, opts);
35
36// Check the result file
37auto re = result->getFile();
38std::ifstream f(re.c_str());
39if(!f.good())
40{
41    throw std::runtime_error("Conversion failed");
42}

Python

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Python. Puede descargar el SDK de Python desde el repositorio de 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
14options = {
15    'width': 8.3,
16    'height': 11.7,
17    'topmargin': 0.2,
18    'bottommargin': 0.2,
19    'leftmargin': 0.2,
20    'rightmargin': 0.2
21}
22
23try:
24    res = html_api.convertApi.convert_local_to_local(input_file="test.md", output_file="test.pdf", options=options)
25except ApiException as ex:
26    print("Exception")
27    print("Info: " + str(ex))
28    raise ex

PHP

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando PHP. Puede descargar el SDK de PHP desde el repositorio de 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.md';
15$dst = 'output.pdf';
16
17$options_a4 = [
18    'width' => 8.3,
19    'height' => 11.7,
20    'left_margin' => 0.2,
21    'right_margin' => 0.2,
22    'top_margin' => 0.2,
23    'bottom_margin' => 0.2
24];
25
26
27try {
28    // Request to server Api
29    $result = $api_html->convertLocalToLocal($src, $dst, $options_a4);
30    print_r($result);
31} catch (Exception $e) {
32    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
33}
34?>

Ruby

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Ruby. Puede descargar el SDK de Ruby desde el repositorio de 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 = "test.md" # String | Source file.
20dst = "test.pdf" # String | Result file.
21
22opts = { 
23  width: 8.3,        # Float | Resulting document width in inches.
24  height: 11.7,      # Float | Resulting document height in inches.
25  left_margin: 0.2,  # Float | Left resulting document margin in inches.
26  right_margin: 0.2, # Float | Right resulting document margin in inches.
27  top_margin: 0.2,   # Float | Top resulting document margin in inches.
28  bottom_margin: 0.2 # Float | Bottom resulting document margin in inches.
29}
30
31begin
32  #Convert the HTML file from the local file and save result to the local file.
33  result = api_instance.convert_local_to_local(src, dst, opts)
34  p result
35rescue AsposeHtml::ApiError => e
36  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
37end

Node.js

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Node.js.

 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.md"; // {String} Source document.
19var dst = "/path/to/dst/test.pdf"; // {String} Result document.
20var opts = {
21    'width': 8.3,
22    'height': 11.7,
23    'leftMargin': 0.2,
24    'rightMargin': 0.2,
25    'topMargin': 0.2,
26    'bottomMargin': 0.2
27};
28
29var callback = function(error, data, response) {
30  if (error) {
31    console.error(error);
32  } else {
33    console.log(data);
34  }
35};
36
37conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

El siguiente ejemplo demuestra cómo convertir Markdown a PDF aplicando el lenguaje Swift. Puede descargar el SDK de Swift desde el repositorio de 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.md"
27let format = "pdf"
28let src = url(forResource: fileName).absoluteString
29let options = Options(width: 8.3, height: 11.7, leftMargin: 0.2,
30        rightMargin: 0.2, topMargin: 0.2, bottomMargin: 0.2)
31
32
33let expectation = self.expectation(description: "testConvert to \(format)")
34let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
35HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: options) { (data, error) in
36
37	guard error == nil else {
38		XCTFail("Error convert Markdown to \(format)). Error=\(error!.localizedDescription)")
39		return
40	}
41	let resultPath = data!.file!
42	XCTAssertTrue(fileExist(name: resultPath))
43	expectation.fulfill()
44}
45self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando Java/Android. Markdown se toma de un sistema de archivos local, se convierte a PDF y se guarda en la unidad local. Puede descargar el SDK de Java/Android desde el repositorio de 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
 6PDFConversionOptions opt_A5 = new PDFConversionOptions()
 7                    .setWidth(5.8)        // A5 format in inches
 8                    .setHeight(8.3)
 9                    .setTopMargin(0.5)
10                    .setBottomMargin(0.5)
11                    .setLeftMargin(0.5)
12                    .setRightMargin(0.5)
13                    .setQuality(95);
14
15JobBuilder builder = new ConverterBuilder()
16                .fromLocalFile("input.md")
17                .useOptions(opt_A5)
18                .saveToLocal("output.pdf");
19
20OperationResult result = api.convert(builder);

CURL

Cargar el archivo local al almacenamiento.
Llame a la API REST para ejecutar la conversión (en el ejemplo siguiente).
Descargar el resultado de la conversión desde el almacenamiento.

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando la API REST. Local Markdown convertido a PDF y guardado en el sistema de archivos local. Siga algunos pasos requeridos:

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/md-pdf" \
3    -d "{'InputPath': '/testpage.md', 'OutputFile': 'test.pdf', 'Options': {'Width':1000, 'Height': 800, 'LeftMargin': 10, 'RightMargin': 10, 'TopMargin': 10, 'BottomMargin': 10}}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization: bearer <token>"

Más detalles sobre los parámetros de conversión disponibles para archivos Markdown se encuentran en la sección Opciones de conversión SDK.

Ejemplo 3. Convertir Markdown a PDF dentro del almacenamiento en la nube

Aspose.HTML Cloud le permite obtener un archivo Markdown de su almacenamiento en la nube y guardar el resultado de la conversión en el almacenamiento en la nube. La conversión se produce con las opciones de conversión predeterminadas.

El siguiente ejemplo muestra cómo convertir Markdown a PDF usando C#. El archivo Markdown se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda nuevamente en el almacenamiento en la nube. Puede descargar el SDK de C# desde el repositorio de GitHub.

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

Java

El siguiente ejemplo muestra cómo convertir Markdown a PDF usando Java. Markdown se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda en el almacenamiento en la nube. Puede descargar el SDK de Java desde el repositorio de 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.md")
 8                .saveToStorage("output.pdf");
 9
10OperationResult result = api.convert(builder);

C++

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando C++. El archivo Markdown se almacena en la nube, luego se convierte a formato PDF y finalmente se guarda nuevamente en la misma ubicación de almacenamiento en la nube.

 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.md";
17utility::string_t dst = L"result/in/storage/result.pdf";
18
19// Conversion
20auto result = api->convertStorageToStorage(src, dst);

Python

El siguiente ejemplo muestra cómo convertir Markdown a PDF aplicando el lenguaje Python. El archivo Markdown se almacena en la nube, luego se convierte a formato PDF y finalmente se guarda nuevamente en la misma ubicación de almacenamiento en la nube. Puede descargar el SDK de Python desde el repositorio de 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.md", output_file="test.pdf",
16                                                         storage_name=None)
17except ApiException as ex:
18    print("Exception")
19    print("Info: " + str(ex))
20    raise ex

PHP

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando PHP. Markdown se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda en la nube. Puede descargar el SDK de PHP desde el repositorio de 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.md";
15$dst = 'FolderInStorage/test.pdf';
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

El siguiente ejemplo muestra cómo convertir Markdown a PDF aplicando el lenguaje Ruby. El archivo Markdown se almacena en la nube, luego se convierte a formato PDF y finalmente se guarda nuevamente en la misma ubicación de almacenamiento en la nube. Puede descargar el SDK de Ruby desde el repositorio de 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.md" # String | Source file.
20dst = "FolderInStorage/test.pdf" # 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

El siguiente ejemplo muestra cómo convertir Markdown a PDF aplicando el lenguaje Node.js. El archivo Markdown se almacena en la nube, luego se convierte a formato PDF y finalmente se guarda nuevamente en la misma ubicación de almacenamiento en la nube.

 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.md"; // {String} Source document.
19var dst = "FolderInStorage/test.pdf"; // {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

El siguiente ejemplo muestra cómo convertir Markdown a PDF aplicando el lenguaje Swift. Markdown se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda en el almacenamiento en la nube. Puede descargar el SDK de Swift desde el repositorio de 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.md"
15let dst = "FolderInStorage/test.pdf"
16
17let expectation = self.expectation(description: "testConvert to pdf")
18
19HtmlAPI.convertStorageToStorage(src: src, dst: dst, storage: nil, options: nil) { (data, error) in
20
21    guard error == nil else {
22        XCTFail("Error convert Markdown to pdf. 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

El siguiente ejemplo muestra cómo convertir Markdown a PDF usando Java/Android. El archivo Markdown se almacena en la nube, luego se convierte a formato PDF y finalmente se guarda nuevamente en la misma ubicación de almacenamiento en la nube. Puede descargar el SDK de Java/Android desde el repositorio de 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.md")
 8                .saveToStorage("output.pdf");
 9
10OperationResult result = api.convert(builder);

CURL

El siguiente ejemplo demuestra cómo convertir Markdown a PDF usando la API REST. El archivo Markdown se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda nuevamente en el almacenamiento en la nube.

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

Ver también

El artículo SDK disponibles le presenta la capacidad de Aspose.HTML Cloud para usar SDK en varios lenguajes de programación, como C#, Java, Python, Ruby, PHP, Node.js, Swift, Android y C++.
El artículo Opciones de conversión describe un conjunto de clases que representan opciones para convertir un documento fuente basado en HTML a PDF, XPS e imagen.
Aspose.HTML Cloud API a la que puedes llamar directamente desde tu navegador accediendo a la Referencia de API.
Aspose.HTML ofrece un Convertidor de Markdown a PDF gratuito en línea que convierte rápidamente Markdown a PDF con alta calidad. ¡Simplemente cargue sus archivos, conviértalos y obtenga el resultado en unos segundos!

Convertidor Markdown Convertir Markdown a XPS