使用 Java API 将 HTML 转换为 DOCX

Aspose.HTML for Java 使用 Converter.convertHTML() 将 HTML 和 CSS 转换为可编辑的 DOCX 文档。将源内容加载到 HTMLDocument ,创建 DocSaveOptions ,并指定目标路径。转换器会将 HTML、关联资源和页面布局渲染为与 Microsoft Word 兼容的文档。

HTML 和 DOCX 使用不同的布局模型。在生产编辑工作流中使用输出文件之前,请通过有代表性的文档测试分页符、表格、定位内容、字体和复杂 CSS。


从 HTML 文件创建 DOCX 文档

此示例加载 document.html,创建默认的 DOCX 保存选项,并将可编辑文档写入 output.docx。

使用 Java 将 HTML 转换为 DOCX

import com.aspose.html.HTMLDocument;
import com.aspose.html.converters.Converter;
import com.aspose.html.saving.DocSaveOptions;

// Load the HTML document
try (HTMLDocument document = new HTMLDocument("document.html")) {
    // Create the DOCX save options
    DocSaveOptions options = new DocSaveOptions();

    // Convert HTML to DOCX
    Converter.convertHTML(document, options, "output.docx");
}

在线测试 HTML 转 DOCX

上传 HTML 文件或输入网页 URL,在 Java 应用程序中实现转换之前检查 DOCX 输出结果。在线转换器适合手动测试。如果工作流需要自动运行或作为服务器端流程的一部分,请使用 Aspose.HTML for Java。

HTML 转 DOCX API 工作流程

  1. 使用 Maven 或 Gradle 将 Aspose.HTML for Java 添加到项目中。
  2. 使用 HTMLDocument 加载 HTML 文件、字符串、流或 URL。
  3. 创建 DocSaveOptions 实例。
  4. 如果默认设置不合适,请配置页面布局、分辨率、背景或字体嵌入。
  5. 将文档、选项和输出路径传递给 Converter.convertHTML() 。

配置 DOCX 布局和字体

DocSaveOptions 用于控制页面大小和边距、水平和垂直分辨率、页面背景、CSS 处理、输出文档格式以及字体嵌入。当 HTML 内容必须适合特定的 Word 页面大小时,请使用页面设置。嵌入字体可以减少 DOCX 对打开文档的系统中已安装字体的依赖,但也可能增加输出文件的大小。

相对路径的样式表、图像和字体根据文档 URL 或为内存中 HTML 提供的基准 URI 进行解析。需要身份验证或 Java 应用程序无法访问的资源可能不会出现在转换后的文档中。

有关页面设置示例,请参阅 使用 Java 将 HTML 转换为 DOCX 。有关可用设置,请参阅 DocSaveOptions API 参考 。


安装 Aspose.HTML for Java

从 Aspose 官方存储库添加 Aspose.HTML for Java。将 ASPOSE_HTML_VERSION 替换为 Aspose.HTML for Java 版本页面 中的确切版本号,然后重新加载或重新构建项目,使依赖项得到正确解析。

将存储库和依赖项添加到 Maven 项目:

Maven – pom.xml

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <url>https://releases.aspose.com/java/repo/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-html</artifactId>
        <version>ASPOSE_HTML_VERSION</version>
    </dependency>
</dependencies>

将存储库和依赖项添加到 Gradle 项目:

Gradle – build.gradle

repositories {
    maven {
        url = uri('https://releases.aspose.com/java/repo/')
    }
}
dependencies {
    implementation 'com.aspose:aspose-html:ASPOSE_HTML_VERSION'
}

请使用与所选版本兼容的 JDK。有关手动安装 JAR、Kotlin DSL、更新和依赖项故障排除的信息,请参阅 安装 Aspose.HTML for Java 。


HTML 转 DOCX 常见问题

1. Java 可以将 HTML 字符串或网页 URL 转换为 DOCX 吗?

可以。从文件、URL、带基准 URI 的字符串或支持的流源创建 HTMLDocument,然后将文档与 DocSaveOptions 一起传递给 Converter.convertHTML()。

2. 从 HTML 创建的 DOCX 可以编辑吗?

可以。输出结果是与 Word 兼容的可编辑文档。HTML 和 DOCX 使用的布局模型并不相同,因此复杂 CSS、表格、定位元素和分页符可能会重新排列。请使用有代表性的输入内容测试转换结果。

3. 可以设置 DOCX 页面大小、边距和字体嵌入吗?

可以。在调用 Converter.convertHTML() 之前,使用 DocSaveOptions 提供的页面设置和字体嵌入选项。字体是否可用以及字体嵌入规则都会影响文档外观和文件大小。

4. 可以免费在线将 HTML 转换为 DOCX 吗?

可以。使用 免费在线 HTML 转 DOCX 转换器 执行手动转换。自动化或集成式转换工作流请使用 Aspose.HTML for Java。