Convertir Markdown a PDF en Python

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

Convertidor de Markdown en línea

Puede convertir Markdown a otros formatos con Aspose.HTML en tiempo real. Cargue un archivo Markdown, seleccione el formato de salida y ejecute el ejemplo. Las opciones de guardado están configuradas de forma predeterminada. Recibirá instantáneamente 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 Python.

Convertir Markdown a PDF

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. Cargue un documento fuente de Markdown. En el ejemplo, creamos un archivo Markdown a partir del código.
2. Convierta Markdown a HTML. Utilice el método convert_markdown() para guardar Markdown como un documento HTML.
3. Cree un nuevo objeto PdfSaveOptions y especifique las propiedades requeridas.
4. Utilice el método convert_html() de la clase Converter. Debe pasar HTMLDocument, PdfSaveOptions y la ruta del archivo de salida save_path al método convert_html().

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:

# Convert Markdown to PDF using Python

import os
import aspose.html.converters as conv
import aspose.html.saving as sav

# Setup output directory and paths
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)
source_path = os.path.join(output_dir, "document.md")
save_path = os.path.join(output_dir, "markdown-to-pdf.pdf")

# Create a simple Markdown example file
code = "### Hello, World!\nConvert Markdown to PDF!"
with open(source_path, "w") as file:
    file.write(code)

# Convert Markdown file to an intermediate HTMLDocument
document = conv.Converter.convert_markdown(source_path)

# Create an instance of PdfSaveOptions
options = sav.PdfSaveOptions()

# Convert HTML to PDF
conv.Converter.convert_html(document, options, save_path)

Convierta Markdown a PDF usando PdfSaveOptions

El proceso de conversión de Markdown a PDF se puede personalizar de forma flexible. Aspose.HTML for Python via .NET proporciona la clase PdfSaveOptions, que le brinda más control sobre cómo se guardan los documentos en formato PDF. Aquí hay una descripción de las propiedades disponibles en PdfSaveOptions:

• page_setup: esta propiedad proporciona acceso a un objeto PageSetup utilizado para configurar el diseño y los ajustes de las páginas PDF de salida para ajustarse a requisitos específicos de impresión o visualización.
• horizontal_resolution: esta propiedad controla la resolución horizontal tanto para las imágenes internas utilizadas durante el procesamiento como para cualquier imagen externa incluida en el HTML. De forma predeterminada, está configurado en 300 ppp.
• vertical_resolution: similar a la resolución_horizontal, esta propiedad administra la resolución vertical de imágenes internas y externas durante la generación de PDF. Al igual que su contraparte horizontal, el valor predeterminado es 300 ppp.
• background_color: esta propiedad establece o recupera el color de fondo que llena cada página del documento PDF. El valor predeterminado es transparente, pero se puede personalizar para adaptarlo a las preferencias estéticas o de marca, lo que garantiza la coherencia en todas las páginas.
• css: esta propiedad utiliza un objeto CssOptions para configurar el procesamiento de propiedades CSS durante la conversión de HTML a PDF. Permite un control preciso sobre cómo se interpretan y aplican los estilos del HTML en el PDF resultante.
• document_info: esta propiedad contiene metadatos e información sobre el documento PDF de salida, como título, autor, tema y palabras clave. Estos metadatos ayudan a la gestión, indexación y búsqueda de documentos, lo que hace que el PDF sea más informativo y organizado.
• form_field_behaviour: esta propiedad especifica el comportamiento de los campos del formulario interactivo en el PDF generado.
• jpeg_quality: esta propiedad determina la calidad de compresión JPEG utilizada para las imágenes incrustadas en un documento PDF. La calidad predeterminada está establecida en 95, lo que proporciona un buen equilibrio entre la fidelidad de la imagen y el tamaño del archivo. Establecer esta propiedad le permite optimizar el tamaño del archivo o la calidad de la imagen según sus necesidades específicas.
• encryption: esta propiedad proporciona información detallada sobre el cifrado de documentos PDF, incluida la protección con contraseña y la configuración de permisos. Si no está configurado, no se aplica ningún cifrado, pero configurar esta propiedad le permite distribuir y controlar el acceso a contenido PDF confidencial de forma segura.
• is_tagged_pdf: cuando se establece en verdadero, se crea un diseño etiquetado dentro del documento PDF, lo que mejora la accesibilidad para usuarios con discapacidades. Esto garantiza que el contenido esté estructurado adecuadamente y sea navegable utilizando tecnología de asistencia y cumpla con los estándares de accesibilidad.

Debe utilizar la clase PdfSaveOptions para especificar opciones adicionales que afectan el resultado de guardar un documento como PDF. Esta clase contiene propiedades que determinan cómo se mostrará la salida del PDF. El siguiente fragmento de código de Python muestra cómo convertir Markdown a PDF usando PdfSaveOptions:

# Convert Markdown to PDF using Python with custom settings

import os
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.drawing as dr

# Setup directories and define paths
output_dir = "output/"
input_dir = "data/"
if not os.path.exists(output_dir):
    os.makedirs(output_dir)
document_path = os.path.join(input_dir, "document.md")
save_path = os.path.join(output_dir, "md-to-pdf-with-save-options.pdf")

# Convert Markdown to HTML
document = conv.Converter.convert_markdown(document_path)

# Create an instance of PdfSaveOptions
options = sav.PdfSaveOptions()
options.page_setup.any_page = dr.Page(dr.Size(300, 300), dr.Margin(30, 10, 10, 10))
options.css.media_type.PRINT
options.jpeg_quality = 100

# Convert HTML to PDF
conv.Converter.convert_html(document, options, save_path)

En este código, la clase PdfSaveOptions de Aspose.HTML for Python via .NET se utiliza para personalizar la conversión de Markdown a PDF.

• La propiedad page_setup configura los ajustes de diseño de página para el PDF de salida, estableciendo el tamaño de página en 300x300 unidades con márgenes de 10 unidades en todos los lados.
• jpeg_quality está establecido en 100, lo que maximiza la calidad de cualquier imagen JPEG incluida en el PDF.
• css.media_type está configurado en PRINT, lo que especifica que el tipo de medio CSS para impresión debe usarse durante la conversión, asegurando un estilo adecuado.

Estas configuraciones garantizan que el PDF resultante tenga el formato correcto, el estilo adecuado para imprimir y contenga imágenes de alta calidad.

Cómo convertir Markdown a XPS

Aspose.HTML for Python via .NET admite la conversión de Markdown a XPS. Para hacer esto, debes usar XpsSaveOptions para obtener un objeto de opciones de guardado que se pasa al método convert_html():

opciones = XpsSaveOptions()

El uso de XpsSaveOptions le permite personalizar el proceso de renderizado; puede especificar las propiedades page_setup, background_color, css, horizontal_resolution y vertical_resolution.

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

Puede descargar los ejemplos completos y los archivos de datos desde GitHub.

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!