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:
- Cargue un documento fuente de Markdown. En el ejemplo, creamos un archivo Markdown a partir del código.
- Convierta Markdown a HTML. Utilice el método convert_markdown() para guardar Markdown como un documento HTML.
- Cree un nuevo objeto PdfSaveOptions y especifique las propiedades requeridas.
- Utilice el método
convert_html() de la clase Converter. Debe pasar
HTMLDocument
,PdfSaveOptions
y la ruta del archivo de salidasave_path
al métodoconvert_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:
1import os
2from aspose.html import *
3from aspose.html.saving import *
4from aspose.html.converters import *
5
6# Prepare a path to a source Markdown file
7output_dir = "output/"
8source_path = os.path.join(output_dir, "document.md")
9
10# Prepare a simple Markdown example
11code = "### Hello, World!\nConvert Markdown to PDF!"
12
13# Create a Markdown file
14with open(source_path, "w") as file:
15 file.write(code)
16
17# Convert Markdown to HTML document
18document = Converter.convert_markdown(source_path)
19
20# Create an instance of PdfSaveOptions
21options = PdfSaveOptions()
22
23# Prepare a path to save the converted file
24save_path = os.path.join(output_dir, "markdown-to-pdf.pdf")
25
26# Convert HTML to PDF
27Converter.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:
1import os
2from aspose.html import *
3from aspose.html.converters import *
4from aspose.html.saving import *
5from aspose.html.drawing import *
6
7# Setup directories and define paths
8output_dir = "output/"
9input_dir = "data/"
10if not os.path.exists(output_dir):
11 os.makedirs(output_dir)
12document_path = os.path.join(input_dir, "document.md")
13save_path = os.path.join(output_dir, "output.pdf")
14
15# Convert Markdown to HTML document
16document = Converter.convert_markdown(document_path)
17
18# Create an instance of PdfSaveOptions
19options = PdfSaveOptions()
20options.page_setup.any_page = Page(Size(300, 300), Margin(10, 10, 10, 10))
21options.css.media_type.PRINT
22options.jpeg_quality = 100
23
24# Convert HTML to PDF
25Converter.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 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!