Java轻松转换Markdown文件到Word和PDF文档

news2025/3/17 18:17:29

Markdown 凭借其简洁易用的特性，成为创建和编辑纯文本文档的常用选择。但某些时候我们需要更加精致的展示效果，例如在专业分享文档或打印成离线使用的纸质版时，就需要将Markdown文件以其他固定的文档格式呈现。通过将 Markdown 转换为 Word 和 PDF 格式，可以得到更多的格式设置，确保跨平台的兼容性，并能够创建出专业的文档。本文将探讨如何使用 Java 将 Markdown 格式转换为 Word 和 PDF 格式。

使用 Java 将 Markdown 文件转换为 Word 文档
使用 Java 将 Markdown 文件转换为 PDF 文件
自定义生成文档的页面设置

本文采用的方法需要 Spire.Doc for Java 库的支持。

使用 Java 将 Markdown 文件转换为 Word 文档

Markdown 格式转换为 Word 或 PDF 文档格式，可以通过调用 Document.loadFromFile(String: fileName, FileFormat.Markdown) 方法加载 Markdown 文件，以及使用 Document.saveToFile(String: fileName, FileFormat: fileFormat) 方法保存为 Word 或 PDF 文档来简单完成。需要注意的是，由于 Markdown 文件中的图片是以链接形式存储的，如果希望在转换后保留图片，还需进行额外处理。
Markdown 文件转换为 Word 文档的具体步骤如下：

导入必要的模块。
创建 Document 类的实例。
使用 Document.loadFromFile(String: fileName, FileFormat.Markdown) 方法加载 Markdown 文件。
通过 Document.saveToFile(String: fileName, FileFormat.Docx) 方法将 Markdown 文件保存为 Word 文档。
释放资源。

代码示例：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class MarkdownToWord {
    public static void main(String[] args) {
        // 创建一个 Document 实例
        Document doc = new Document();

        // 加载 Markdown 文件
        doc.loadFromFile("示例.md", FileFormat.Markdown);

        // 将 Markdown 文件保存为 Word 文档
        doc.saveToFile("output/Markdown转Word.docx", FileFormat.Docx);
        doc.dispose();
    }
}

原Markdown文件：
Java 将 Markdown 文件转换为 Word 文档

转换结果：
Java 将 Markdown 文件转换为 Word 文档

使用 Java 将 Markdown 文件转换为 PDF 文件

只需在 Document.saveToFile() 方法的格式参数中使用 FileFormat.PDF 枚举，即可直接将 Markdown 文件转换为 PDF 文档。
Markdown 文件转换为 PDF 文档的步骤如下：

导入必要的模块。
创建 Document 类的实例。
使用 Document.loadFromFile(String: fileName, FileFormat.Markdown) 方法加载 Markdown 文件。
利用 Document.saveToFile(String: fileName, FileFormat.PDF) 方法将 Markdown 文件保存为 PDF 文档。
释放资源。

代码示例：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class MarkdownToPDF {
    public static void main(String[] args) {
        // 创建一个 Document 实例
        Document doc = new Document();

        // 加载 Markdown 文件
        doc.loadFromFile("示例.md");

        // 将 Markdown 文件保存为 PDF 文件
        doc.saveToFile("output/Markdown转PDF.pdf", FileFormat.PDF);
        doc.dispose();
    }
}

转换结果：
Java 将 Markdown 文件转换为 PDF 文件

自定义生成文档的页面设置

除了默认样式转换外，我们还可以在转换前利用 PageSetup 类下的方法进行页面设置，从而控制生成文档的页面边距、页面大小等属性。
自定义生成文档页面设置的步骤如下：

导入必要的模块。
创建 Document 类的实例。
使用 Document.loadFromFile(String: fileName, FileFormat.Markdown) 方法加载 Markdown 文件。
通过 Document.getSections().get(0) 方法获取第一章节。
使用 PageSetup 类下的方法设定页面大小、方向及边距。
通过 Document.saveToFile(String: fileName, FileFormat.PDF) 方法将 Markdown 文件保存为 PDF 文档。
释放资源。

代码示例：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.PageSetup;
import com.spire.doc.Section;
import com.spire.doc.documents.MarginsF;
import com.spire.doc.documents.PageOrientation;
import com.spire.doc.documents.PageSize;

public class PageSettingMarkdown {
    public static void main(String[] args) {
        // 创建一个 Document 实例
        Document doc = new Document();

        // 加载 Markdown 文件
        doc.loadFromFile("示例.md");

        // 获取第一个节
        Section section = doc.getSections().get(0);

        // 设置页面尺寸、方向和边距
        PageSetup pageSetup = section.getPageSetup();
        pageSetup.setPageSize(PageSize.Letter);
        pageSetup.setOrientation(PageOrientation.Landscape);
        pageSetup.setMargins(new MarginsF(100, 100, 100, 100));

        // 将 Markdown 文件保存为 PDF 文件
        doc.saveToFile("output/Markdown转PDF.pdf", FileFormat.PDF);
        doc.dispose();
    }
}