如何在 TypeScript 中转换 PDF 文档

步骤 1：安装软件包

git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-TypeScript.git
cd Aspose.PDF-FOSS-for-TypeScript
npm install
npm run build

通过在新的 TypeScript 文件中导入 Document 类来验证安装——一旦软件包安装完成，此行应当能够无错误地解析：

import { Document } from '@asposefoss/pdf';

步骤 2：导入所需类

导入 Document 打开文件；下面使用的转换方法直接在返回的 Document 和 Page 实例上调用，因此无需进一步导入：

import { Document } from '@asposefoss/pdf';

步骤 3：将页面转换为 SVG 或光栅图像

Page.ToSvg() 返回一个独立的 <svg> 字符串。Page.ToImage() 将页面渲染为光栅字节；scale 相对于 PDF 原生的 72 DPI，因此 scale: 2 在 144 DPI 下渲染：

import { Document } from '@asposefoss/pdf';

const doc = Document.OpenFile('input.pdf');
const svg = doc.Pages[0].ToSvg(); // standalone <svg> string
const png = doc.Pages[0].ToImage({ scale: 2 }); // Uint8Array of PNG bytes @144 DPI

步骤 4：将文档转换为 HTML 或 Markdown

Document.ToHtml() 在默认（语义）模式下会将结构树中的内容重新流动为标题和段落；传入 { mode: 'fixed' } 可改为将每页重新生成定位的 SVG 和绝对定位的文本。Document.ToMarkdown() 为整个文档生成 GFM Markdown：

const semanticHtml = doc.ToHtml(); // reflowable markup, all pages
const fixedHtml = doc.ToHtml({ mode: 'fixed', fonts: 'embed' }); // positioned, fonts embedded
const markdown = doc.ToMarkdown(); // GFM Markdown, all pages

语义模式读取由 Document.GetStructTree() / Document.CreateStructTree() 构建的结构树——在未标记的文档上，它会回退到启发式主体，导出时会失去标题结构。

步骤 5：将文档转换为 DOCX

Document.ToDocx() 返回包含已重新流动内容和内部打包图像的 .docx 字节；传入 { mode: 'textbox' } 可保留每页自己的固定几何形状而不是重新流动：

const docx = doc.ToDocx(); // .docx bytes, reflowed, images in the package
const fixed = doc.ToDocx({ mode: 'textbox' }); // .docx keeping each page's own geometry

第6步：验证并转换为 PDF/A

Document.ValidatePdfA(level)、Document.ValidatePdfX(level) 和 Document.ValidatePdfUa() 返回一个 ValidationReport，描述文档是否符合指定标准。Document.ConvertToPdfA(level, opts) 返回一个 ConversionReport，列出它所应用的修复以及仍未解决的问题。当现场文档必须保持未转换保存时，请在 Document.ExtractPages() 副本上运行转换：

const report = doc.ValidatePdfA('2b');
console.log(report.Passed);

const copy = doc.ExtractPages(doc.Pages.map((_, i) => i + 1));
const conversion = copy.ConvertToPdfA('2b');
console.log(conversion.applied.length, conversion.unresolved.length, conversion.passed);
copy.Save();