用 Python 将 Markdown 转换为图像

如果您需要预览 Markdown 文件，您可以将其转换为图像格式。使用 Aspose.HTML for Python via .NET，您只需几行代码就能轻松地将 Markdown 转换为 JPG、PNG、BMP、GIF 或 TIFF 文件！

本文介绍了如何使用 Converter 类将 Markdown 转换为图像格式。您将了解支持的转换场景，并考虑用 Python 代码示例来说明这些场景。此外，您还可以试用在线 Markdown 转换器来测试 Aspose.HTML API 的功能并即时转换 Markdown。

注： 转换器类的所有 convert_markdown() 方法都允许将 Markdown 转换为 HTML。从 Markdown 到其他格式的转换需要经过 Markdown 到 HTML 的转换阶段。

在线 Markdown 转换器

您可以使用 Aspose.HTML 将 Markdown 实时转换为其他格式。请从本地文件系统或 URL 加载 Markdown，选择输出格式并运行示例。 保存选项为默认设置。您将立即以单独文件的形式收到转换结果。

如果您想通过编程将 Markdown 转换为图像格式，请参阅以下 Python 代码示例。

将 Markdown 转换为 PNG

从 Markdown 到其他格式的转换需要经过 Markdown 到 HTML 的转换阶段。要将 Markdown 转换为 PNG，应遵循以下几个步骤：

1. 加载源 Markdown 文档。在示例中，我们从代码中创建了一个 Markdown 文件。
2. 为转换后的文件保存准备路径。
3. 将 Markdown 转换为 HTML。使用 convert_markdown() 方法将 Markdown 保存为 HTML 文档。
4. 创建 ImageSaveOptions 类的实例。默认情况下，“格式 “属性为 PNG。在这里，您可以设置所需的保存选项，如页面设置、分辨率等。
5. 使用 convert_html() 方法将中间 HTML 文档渲染为 PNG 图像。在下面的示例中，您需要将 HTMLDocument、ImageSaveOptions 和输出文件路径 save_path 传递给 convert_html() 方法，以便将 HTML 转换为 PNG。

如果您要在代码中直接从用户字符串创建 Markdown 文档，并将其转换为 PNG 图像，下面的示例可以帮到您：

# Convert Markdown to PNG 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")

# Create a simple Markdown example file
code = "### Hello, World!\nConvert Markdown to PNG!"
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 ImageSaveOptions with PNG format
options = sav.ImageSaveOptions()

# Prepare output file path
save_path = os.path.join(output_dir, "markdown-to-image.png")

# Convert HTMLDocument to PNG image
conv.Converter.convert_html(document, options, save_path)

Aspose.HTML 提供免费的在线 MD to PNG Converter，可将 Markdown 转换为高质量的 PNG 图像，简单快捷。只需上传、转换您的文件，几秒钟就能得到结果！

使用 ImageSaveOptions 将 Markdown 转换为 JPG

将 Markdown 转换为图片的过程可以灵活定制。ImageSaveOptions 类为将 HTML 内容转换为图片格式提供了广泛的自定义功能。以下是对 ImageSaveOptions 各属性的详细说明：

• page_setup – 您可以配置输出图像的页面布局设置。这包括指定页面大小和页边距(上、下、左、右)，以控制图像中 HTML 内容的位置和显示。
• horizontal_resolution – 该属性设置或获取处理过程中使用的输出和内部图像的水平分辨率(单位为每英寸像素)。分辨率越高，图像越清晰，但也会增加文件大小。默认情况下，分辨率为 300 dpi。
• vertical_resolution – 该属性设置或获取内部图像的垂直分辨率，单位为每英寸像素。默认为 300 dpi。
• background_color – 使用此属性可以设置渲染输出的背景颜色。如果未设置，默认背景色为透明色。
• css – 该属性由 CssOptions 表示，允许配置在 HTML 转换为图像时如何处理 CSS 属性。
• format – 该属性决定输出图像的格式。支持的格式包括 PNG、JPEG、BMP、GIF 和 TIFF 等常用图像格式。默认格式为 PNG，但也可根据需要指定其他格式。
• use_antialiasing – 该属性控制转换过程中的图形渲染质量。它会影响图像的渲染方式，这对于抗锯齿和实现平滑、具有视觉吸引力的输出特别有用。选项通常包括高质量渲染设置，这对专业级和演示级图像至关重要。
• compression – 压缩选项允许您设置 TIFF 输出的压缩方法。支持的选项有LZW、CCITT3、CCITT4、RLE 和 NONE。压缩有助于在保持图像质量的同时减小文件大小，这对用于高质量存档和打印图像的 TIFF 文件尤为重要。
• text – 该属性为 HTML 转换为图像时的文本渲染提供配置。

如果你想使用自定义保存选项从本地文件系统转换现有的 Markdown 文档，下面的示例可以帮到你：

# Convert Markdown to JPG 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
import aspose.html.rendering.image as rim

# 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-jpg-with-save-options.jpg")

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

# Create an instance of ImageSaveOptions
options = sav.ImageSaveOptions(rim.ImageFormat.JPEG)
options.horizontal_resolution = dr.Resolution.from_dots_per_inch(200.0)
options.vertical_resolution = dr.Resolution.from_dots_per_inch(200.0)
options.css.media_type.PRINT

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

如何将 Markdown 转换为图像

Aspose.HTML for Python via .NET 支持将 Markdown 转换为 PNG、JPG、JPEG、BMP、TIFF 和 GIF 图像。您可以使用上述 Python 代码来实现这一功能；要设置输出图像格式，您只需在输出文件名中指定所需的扩展名(格式)，并设置保存选项对象的 format 属性。

例如，要将 Markdown 转换为 BMP，您需要

• 来设置格式属性：options = sav.ImageSaveOptions(rim.ImageFormat.BMP)
• 并在输出图像文件名中设置扩展名.bmp：save_path = os.path.join(output_dir, "markdown-to-image.bmp")

下载 Aspose.HTML for Python via .NET库，它能让您成功、快速、轻松地将 HTML、MHTML、EPUB、SVG 和 Markdown 文档转换为最流行的格式。

您可以使用我们的在线 MD 到 JPG 转换器 检查 Markdown 转换为 JPG 的质量。上传、转换文件并在几秒钟内获得结果。现在就免费试用我们强大的 Markdown 转 JPG 转换器！