Convertir Markdown a PDF – C#

Markdown es un lenguaje de marcado con una sintaxis de formato de texto simple. Markdown se utiliza a menudo como formato para documentación y archivos README, ya que permite escribir en un estilo fácil de leer y escribir. Su diseño permite convertirlo fácilmente a muchos formatos de salida, pero inicialmente se creó para convertir solo a HTML. ¡Usando la biblioteca Aspose.HTML for .NET en su aplicación C#, puede convertir fácilmente Markdown en un archivo HTML con solo unas pocas líneas de código!

Este artículo proporciona información sobre cómo convertir Markdown a PDF utilizando Aspose.HTML for .NET API. Aprenderá sobre los escenarios de conversión de Markdown a PDF admitidos y considerará ejemplos de C# para ilustrarlos. Además, puede probar un convertidor de Markdown en línea para probar la funcionalidad de la API Aspose.HTML y convertir Markdown sobre la marcha.

Convertidor de Markdown en línea

Puede convertir Markdown a otros formatos con Aspose.HTML for .NET API en tiempo real. Cargue un archivo Markdown desde el sistema de archivos local, seleccione el formato de salida y ejecute el ejemplo. Las opciones de guardado están configuradas de forma predeterminada. Recibirá inmediatamente el resultado de la conversión como un archivo separado.

Si desea convertir Markdown a PDF mediante programación, consulte los siguientes ejemplos de código C#.

Nota: Las conversiones de Markdown a formatos como PDF, XPS, DOCX y formatos de imagen pasan por la etapa de conversión de Markdown a HTML.

Convertir Markdown a PDF en C#

Si su escenario requiere renderizar un documento Markdown, por ejemplo, al formato de archivo PDF, el siguiente ejemplo demuestra lo simple que es esto:

1. Prepare un documento Markdown fuente. En el ejemplo, creamos un archivo Markdown a partir del código.
2. Prepare una ruta para guardar el archivo convertido.
3. Convierta Markdown a HTML. Utilice el método ConvertMarkdown(sourcePath) para guardar Markdown como un documento HTML.
4. Utilice el método ConvertHTML() para representar el documento HTML intermediario en formato PDF. Debe pasar HTMLDocument, PdfSaveOptions y la ruta del archivo de salida al método ConvertHTML() para la conversión de HTML a PDF.

Si tu caso es crear un documento Markdown a partir de una cadena de usuario directamente en tu código y convertirlo a un archivo PDF, el siguiente ejemplo podría ayudarte:

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(OutputDir, "document.md");

// Prepare a simple Markdown example
var code = "### Hello, World!" +
           "\r\n" +
           "[visit applications](https://products.aspose.app/html/applications)";
// Create a Markdown file
File.WriteAllText(sourcePath, code);

// Convert Markdown to HTML 
using var document = Converter.ConvertMarkdown(sourcePath);

// Prepare a path for converted PDF file saving 
string savePath = Path.Combine(OutputDir, "document-output.pdf");

// Convert the HTML document to PDF file format
Converter.ConvertHTML(document, new PdfSaveOptions(), savePath);

Convierta Markdown a PDF usando PdfSaveOptions

Si su caso es convertir un documento Markdown existente desde un sistema de archivos local, el siguiente ejemplo podría ayudarle. Debes seguir algunos pasos:

1. Abra un documento de Markdown existente. En el ejemplo, cargamos un archivo Markdown desde un sistema de archivos local ( nature.md).
2. Prepare una ruta para guardar el archivo PDF convertido.
3. Convierta Markdown a HTML. Utilice el método ConvertMarkdown(sourcePath) de la clase Converter para guardar Markdown como un documento HTML.
4. Cree un nuevo objeto PdfSaveOptions y especifique las propiedades requeridas.
5. Utilice el método ConvertHTML() para representar el documento HTML intermediario en formato PDF. Debe pasar HTMLDocument, PdfSaveOptions y la ruta del archivo de salida al método ConvertHTML().

El siguiente fragmento de código muestra cómo convertir Markdown a PDF usando Aspose.HTML for .NET.

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(DataDir, "nature.md");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "nature-output.pdf");

// Convert Markdown to HTML
using var document = Converter.ConvertMarkdown(sourcePath);

// Initialize PdfSaveOptions. Set up the resolutions, JpegQuality and change the background color to AliceBlue 
var options = new PdfSaveOptions()
{
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue,
    JpegQuality = 100
};            

// Convert the HTML document to PDF file format
Converter.ConvertHTML(document, options, savePath);

La clase PdfSaveOptions proporciona numerosas propiedades que le brindan control total sobre una amplia gama de parámetros y mejoran el proceso de conversión de Markdown a formato PDF. Para obtener más información sobre PdfSaveOptions, lea el artículo Convertidores de ajuste fino.

En el ejemplo anterior, usamos:

• Propiedad JpegQuality que le permite especificar la calidad de la compresión JPEG para imágenes. El valor predeterminado es 95.
• Propiedad BackgroundColor que establece el color que rellenará el fondo. El color de fondo predeterminado es transparente.
• Propiedades HorizontalResolution y VerticalResolution que establecen la resolución horizontal/vertical para las imágenes de salida en píxeles por pulgada. De forma predeterminada, estas propiedades son 300 ppp.

Descargue nuestra biblioteca Aspose.HTML for .NET que le permite convertir con éxito, rápida y fácilmente sus documentos HTML, MHTML, EPUB, SVG y Markdown a los formatos más populares.

Puede comprobar la calidad de la conversión de Markdown a PDF con nuestro Convertidor de MD a PDF en línea. Sube, convierte tus archivos y obtén resultados en unos segundos. ¡Pruebe nuestro contundente convertidor Markdown a PDF gratis ahora!