在 Aspose.Words for Java 中将文档保存为 Markdown

在 Aspose.Words for Java 中将文档保存为 Markdown 简介

在本分步指南中，我们将演示如何使用 Aspose.Words for Java 将文档另存为 Markdown。 Markdown 是一种轻量级标记语言，通常用于格式化文本文档。使用 Aspose.Words for Java，您可以轻松地将 Word 文档转换为 Markdown 格式。我们将介绍保存 Markdown 文件的不同方面，包括表格内容对齐和处理图像。

先决条件

在开始之前，请确保您具备以下先决条件：

• 您的系统上安装了 Java 开发工具包 (JDK)。
• Aspose.Words for Java 库。您可以从以下位置下载：这里.

第 1 步：创建 Word 文档

我们首先创建一个 Word 文档，稍后将其转换为 Markdown 格式。您可以根据您的要求自定义此文档。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

//插入包含两个单元格的表格
builder.insertCell();
builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
builder.write("Cell1");

builder.insertCell();
builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
builder.write("Cell2");

//将文档另存为 Markdown
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
doc.save("output.md", saveOptions);

在此示例中，我们创建一个包含两个单元格的简单表格，并设置这些单元格内段落的对齐方式。然后，我们使用以下命令将文档另存为 MarkdownMarkdownSaveOptions.

第 2 步：自定义表格内容对齐方式

Aspose.Words for Java 允许您在另存为 Markdown 时自定义表格内容的对齐方式。您可以将表格内容左对齐、右对齐、居中对齐，或者根据每个表格列中的第一个段落自动确定。

以下是自定义表格内容对齐方式的方法：

//设置表格内容左对齐
saveOptions.setTableContentAlignment(TableContentAlignment.LEFT);
doc.save("left_alignment.md", saveOptions);

//设置表格内容右对齐
saveOptions.setTableContentAlignment(TableContentAlignment.RIGHT);
doc.save("right_alignment.md", saveOptions);

//设置表格内容居中对齐
saveOptions.setTableContentAlignment(TableContentAlignment.CENTER);
doc.save("center_alignment.md", saveOptions);

//将表格内容对齐设置为自动（由第一段确定）
saveOptions.setTableContentAlignment(TableContentAlignment.AUTO);
doc.save("auto_alignment.md", saveOptions);

通过改变TableContentAlignment属性，您可以控制转换为 Markdown 时表格内内容的对齐方式。

第 3 步：处理图像

要在 Markdown 文档中包含图像，您需要指定图像所在的文件夹。 Aspose.Words for Java 允许您将图像文件夹设置在MarkdownSaveOptions.

以下是如何设置图像文件夹并保存带有图像的文档：

//加载包含图像的文档
Document doc = new Document("document_with_images.docx");

//设置图片文件夹路径
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
saveOptions.setImagesFolder("images_folder/");

//保存带有图像的文档
doc.save("document_with_images.md", saveOptions);

确保更换"document_with_images.docx"包含图像的 Word 文档的路径和"images_folder/"与存储图像的文件夹的实际路径。

在 Aspose.Words for Java 中将文档保存为 Markdown 的完整源代码

public void autoTableContentAlignment() throws Exception
{
	Document doc = new Document();
	DocumentBuilder builder = new DocumentBuilder(doc);
	builder.insertCell();
	builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
	builder.write("Cell1");
	builder.insertCell();
	builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
	builder.write("Cell2");
	//使表格内的所有段落对齐。
	MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
	{
		saveOptions.setTableContentAlignment(TableContentAlignment.LEFT);
	}
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.LeftTableContentAlignment.md", saveOptions);
	saveOptions.setTableContentAlignment(TableContentAlignment.RIGHT);
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.RightTableContentAlignment.md", saveOptions);
	saveOptions.setTableContentAlignment(TableContentAlignment.CENTER);
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.CenterTableContentAlignment.md", saveOptions);
	//在这种情况下，对齐方式将从相应表列的第一段中获取。
	saveOptions.setTableContentAlignment(TableContentAlignment.AUTO);
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.AutoTableContentAlignment.md", saveOptions);
}
@Test
public void setImagesFolder() throws Exception
{
	Document doc = new Document("Your Directory Path" + "Image bullet points.docx");
	MarkdownSaveOptions saveOptions = new MarkdownSaveOptions(); { saveOptions.setImagesFolder("Your Directory Path" + "Images"); }
	try(ByteArrayOutputStream stream = new ByteArrayOutputStream())
	{
		doc.save(stream, saveOptions);
	}
}

结论

在本指南中，我们探索了如何使用 Aspose.Words for Java 将文档另存为 Markdown。我们介绍了 Word 文档的创建、自定义表格内容对齐以及处理 Markdown 文件中的图像。您现在可以高效地将 Word 文档转换为 Markdown 格式，使其适合各种发布平台和文档需求。

常见问题解答

如何安装 Aspose.Words for Java？

可以通过将库包含在 Java 项目中来安装 Aspose.Words for Java。您可以从以下位置下载该库这里并按照文档中提供的安装说明进行操作。

我可以将包含表格和图像的复杂 Word 文档转换为 Markdown 吗？

是的，Aspose.Words for Java 支持将包含表格、图像和各种格式元素的复杂 Word 文档转换为 Markdown。您可以根据文档的复杂性自定义 Markdown 输出。

如何处理 Markdown 文件中的图像？

要在 Markdown 文件中包含图像，请使用以下命令设置图像文件夹路径setImagesFolder中的方法MarkdownSaveOptions。确保图像文件存储在指定的文件夹中，Aspose.Words for Java 将相应地处理图像引用。

是否有 Aspose.Words for Java 的试用版？

是的，您可以从 Aspose 网站获取 Aspose.Words for Java 的试用版。试用版允许您在购买许可证之前评估库的功能。

在哪里可以找到更多示例和文档？

有关 Aspose.Words for Java 的更多示例、文档和详细信息，请访问文档.