將 TXT 轉換為 HTML、JPG、PNG、PDF，使用 GroupDocs Viewer

在現代 Java 應用程式中，convert txt to html 只是建立彈性文件預覽流程的第一步。使用 GroupDocs Viewer Maven，您可以即時將純文字檔案轉換為適合網頁的 HTML、清晰的 JPG/PNG 圖像，或通用可讀的 PDF。無論您是在構建文件門戶、歸檔服務，或是 SaaS 產品的預覽功能，本指南將帶您完成完整設定，並示範如何 convert txt files java 轉換為所有常見的輸出格式。

Convert TXT Files to HTML, JPG, PNG, and PDF with GroupDocs.Viewer for Java

快速解答

  • 需要哪個 Maven 套件？ com.groupdocs:groupdocs-viewer（請參考以下 Maven 片段）。
  • 我可以渲染多頁 HTML 嗎？ 可以 – 使用 HtmlViewOptions.forEmbeddedResources 並不設定單頁旗標。
  • 生產環境是否需要授權？ 試用版可用於評估；商業使用需購買永久授權。
  • 支援哪個 Java 版本？ Java 8 或更新版本（建議使用 Java 11 以上）。
  • 產生圖像輸出是否需要額外的函式庫？ 不需要，Viewer 函式庫已內建 JPG 與 PNG 支援。

什麼是 GroupDocs Viewer Maven？

GroupDocs Viewer Maven 是 Maven 為基礎的 GroupDocs.Viewer for Java 函式庫發行版。它提供單一、易於使用的 API，能將超過 100 種文件格式（包括純文字）渲染為 HTML、圖像或 PDF，且不需要 Microsoft Office 或任何第三方轉換器。它抽象化了文件渲染的複雜度，讓開發者可以專注於業務邏輯，而非檔案格式處理。

為什麼要 convert txt files java？

將 TXT 檔案轉換為更豐富的格式，可無縫整合至 Web 介面，確保樣式一致，並符合歸檔標準，使內容更易取得且更具專業感。它同時簡化了後續處理，如搜尋索引與內容分析，因為可提供結構化的輸出。

  • 跨平台預覽 – HTML 與圖像可即時在瀏覽器或行動應用程式中顯示。
  • 標準化歸檔 – PDF 保留格式，且通用可讀。
  • 自動化友好 – 在 CI 流程、雲端函式或排程工作中批次轉換 txt 檔案。

前置條件

  • GroupDocs.Viewer for Java 版本 25.2 或更新（透過 Maven 提供）。
  • JDK 8 以上（建議使用 Java 11 以上）。
  • IDE，例如 IntelliJ IDEA、Eclipse 或 NetBeans。
  • 基本的 Java 與 Maven 知識。

設定 GroupDocs.Viewer for Java

將儲存庫與相依性加入您的 pom.xml：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

取得授權步驟

  • 先使用 免費試用，或取得 臨時授權 以探索完整功能。
  • 在生產環境中，請透過官方的 purchase page 購買授權。

基本初始化與設定

  1. 加入上述的 Maven 依賴。
  2. 確認您的 JDK 與 IDE 已正確設定。

Definition anchor: Viewer 是 GroupDocs.Viewer 的核心類別，用於載入來源文件並將其渲染為選定的輸出格式。

實作指南

功能 1：將 TXT 渲染為多頁 HTML (multi page html java)

Direct answer: 使用 HtmlViewOptions.forEmbeddedResources 並呼叫 viewer.view(documentPath, options) – 這會產生一系列 HTML 頁面，每頁代表原始文字的一部分，且會自動嵌入 CSS 與圖像。

Definition anchor: HtmlViewOptions 設定 Viewer 渲染文件為 HTML 時的分頁、資源嵌入與 CSS 處理方式。

匯入所需函式庫

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

設定路徑與 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Render the document to HTML using these options
    viewer.view(options);
}

Explanation: HtmlViewOptions.forEmbeddedResources 會將 CSS、字型與圖像直接打包進 HTML 輸出，使其具備可攜性。

功能 2：將 TXT 渲染為單頁 HTML (convert txt to html java)

Direct answer: 在呼叫 viewer.view 前使用 HtmlViewOptions.forEmbeddedResources().setRenderToSinglePage(true)，整個 TXT 內容將被壓縮成一個 HTML 檔案，適合快速預覽。

Definition anchor: setRenderToSinglePage(true) 會強制 Viewer 將所有產生的頁面合併為單一 HTML 文件。

匯入所需函式庫

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

設定路徑與 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Set the option to render as a single page HTML
    options.setRenderToSinglePage(true);
    
    // Render the document using these options
    viewer.view(options);
}

Explanation: setRenderToSinglePage(true) 會將所有頁面合併為一個 HTML 檔案。

功能 3：將 TXT 渲染為 JPG

Direct answer: 建立 JpgViewOptions 實例，必要時設定 DPI 以提升品質，然後傳入 viewer.view；Viewer 會為來源 TXT 的每一頁輸出 JPEG 圖像。

Definition anchor: JpgViewOptions 定義影像專屬的渲染設定，如解析度、品質與 JPEG 轉換的輸出資料夾。

匯入所需函式庫

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

設定路徑與 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a JPEG image
    JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
    
    // Render the document as a JPG using these options
    viewer.view(options);
}

Explanation: JpgViewOptions 讓您控制圖像品質、DPI 與輸出路徑。

功能 4：將 TXT 渲染為 PNG

Direct answer: 使用 PngViewOptions 並設定所需 DPI（例如 300），呼叫 viewer.view；結果為每頁一個無損 PNG 圖像，完整保留文字的視覺佈局。

Definition anchor: PngViewOptions 提供將文件渲染為 PNG 圖像的設定，支援無損壓縮與自訂解析度。

匯入所需函式庫

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

設定路徑與 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PNG image
    PngViewOptions options = new PngViewOptions(pageFileFullPath);
    
    // Render the document as a PNG using these options
    viewer.view(options);
}

Explanation: PNG 提供無損壓縮，保留原始文字的精確外觀。

功能 5：將 TXT 渲染為 PDF (txt to pdf java / convert txt to pdf java)

Direct answer: 建立 PdfViewOptions，必要時設定頁面大小（例如 A4），然後呼叫 viewer.view；函式庫會自動處理分頁、字型與資源嵌入，產生高保真 PDF。

Definition anchor: PdfViewOptions 控制 PDF 專屬的渲染層面，如頁面大小、邊距與字型嵌入。

匯入所需函式庫

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

設定路徑與 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PDF
    PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
    
    // Render the document as a PDF using these options
    viewer.view(options);
}

Explanation: PdfViewOptions 會自動處理頁面佈局、字型與資源嵌入。

實務應用

  1. 文件管理系統： 自動將舊有 TXT 文件轉換為 HTML，以供內部入口網站使用。
  2. 出版平台： 將作者提交的 TXT 手稿轉換為 HTML，實現無縫的 CMS 整合。
  3. 歸檔解決方案： 將舊文字檔案保存為 PDF 或 PNG，以供長期存儲與合規使用。
  4. 雲端儲存整合： 即時轉換並將渲染後的檔案存入 AWS S3、Azure Blob 或 Google Cloud。

常見問題與解決方案

IssueCauseFix
輸出為空白檔案路徑不正確或缺少讀取權限。確認 YOUR_DOCUMENT_DIRECTORY 指向實際的 TXT 檔案，且程式具有讀取權限。
圖像品質低預設 DPI 較低。使用 JpgViewOptions.setResolution(int dpi) 或 PngViewOptions.setResolution(int dpi) 提高 DPI（例如 300）。
HTML 包含破損的連結資源未嵌入。使用 HtmlViewOptions.forEmbeddedResources 或提供自訂的資源資料夾。
授權例外未設定有效的授權。在建立 Viewer 之前，使用 License license = new License(); license.setLicense("path/to/license.file"); 載入授權檔案。

常見問答

Q: 我可以使用 GroupDocs.Viewer 轉換大型 TXT 檔案（數百 MB）嗎？
A: 可以。函式庫會串流來源檔案，但對於非常大的文件，您可能需要增加 JVM 記憶體堆積大小。

Q: 產生 JPG 或 PNG 時需要額外的相依性嗎？
A: 不需要。Viewer 套件已內建所有必要的影像處理函式庫。

Q: 是否可以自訂 PDF 的頁面大小？
A: 當然可以。渲染前使用 PdfViewOptions.setPageSize(PageSize.A4) 或其他 PageSize 即可。

Q: 如何處理受密碼保護的 TXT 檔案？
A: TXT 檔案本身不支援密碼保護。如果檔案被加密，請先解密後再交給 Viewer。

Q: 我能在 Docker 容器中執行此轉換嗎？
A: 能。將 JDK、pom.xml（含 GroupDocs 相依性）複製到容器內，然後在容器中執行 Java 應用程式即可。

Last Updated: 2026-07-24
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs

相關教學