Conversion

Overzicht

Deze pagina behandelt het renderen van een PDF naar andere formaten en het converteren van een document naar PDF/A compliance. Document biedt één To*() methode per uitvoerformaat voor het hele document; dezelfde methoden bestaan op Page om een enkele pagina te renderen.


Renderen naar andere documentformaten

Document.ToHtml(), Document.ToDocx() en Document.ToMarkdown() renderen elke pagina; Page.ToSvg() en Page.ToImage() renderen één pagina naar een zelfstandige SVG-string of PNG-bytes. Elk accepteert zijn eigen opties — mode op DocxOptions (‘flow’ herschikt de inhoud, ’textbox’ behoudt de geometrie van elke pagina) en images op MarkdownExportOptions (‘inline’ embedde afbeeldings-data-URI’s, ’external’ schrijft afzonderlijke bestanden naar imageDir).

const doc = Document.OpenFile('in.pdf');
const svg = doc.Pages[0].ToSvg();               // standalone <svg> string
const png = doc.Pages[0].ToImage({ scale: 2 }); // Uint8Array of PNG bytes @144 DPI
const html = doc.ToHtml();                      // standalone semantic HTML, all pages
const md = doc.ToMarkdown();                    // GFM Markdown, all pages
const docx = doc.ToDocx();                      // .docx bytes, reflowed, images in the package
const fixed = doc.ToDocx({ mode: 'textbox' });  // .docx keeping each page's own geometry

ImageOptions (voor Page.ToImage()) accepteert ook format, quality, scale, een expliciete width / height, en background (‘white’ of ’transparent’).


Converteren naar PDF/A

Document.ConvertToPdfA() probeert een document te remediëren richting een PDF/A level (‘b’ of ‘u’) en valideert het opnieuw, waarbij het een ConversionReport retourneert met applied (de uitgevoerde remediatie-acties), unresolved (problemen die niet konden worden verholpen), en passed. Voer het uit op een kopie — bijvoorbeeld een exemplaar gemaakt met Document.ExtractPages() — zodat het live, werkende document nooit wordt gewijzigd door de conversie.

// ExtractPages gives an independent copy; ConvertToPdfA never touches the original.
const copy = doc.ExtractPages(doc.Pages.map((_, i) => i + 1));
const conversion = copy.ConvertToPdfA('2b');

console.log(`applied ${conversion.applied.length} action(s), `
  + `${conversion.unresolved.length} unresolved, `
  + `result: ${conversion.passed ? 'passes' : 'still fails'} PDF/A-2b`);
copy.WriteTo('output-pdfa.pdf');

Andere exportformaten

Naast HTML, Markdown, DOCX, SVG en PNG exporteert de bibliotheek ook TIFF (TiffExportOptions, encodeTiff()) en importeert/exporteert AcroForm veldwaarden in FDF en XFDF (exportFdfFile(), exportXfdfFile(), importFdfFile(), importXfdfFile()) — handig voor het uitwisselen van ingevulde formuliergegevens los van de PDF zelf.


Tips en best practices

  • Voer Document.ConvertToPdfA() uit op een kopie (bijvoorbeeld vanuit Document.ExtractPages()), nooit op het live-document dat je nog moet opslaan zonder conversie.
  • Controleer ConversionReport.unresolved zelfs wanneer passed true is voor een lossere validatieniveau — sommige herstelacties lossen pas volledig op bij een strenger niveau.
  • Gebruik mode: 'textbox' op DocxOptions wanneer de DOCX-output de exacte visuele geometrie van elke pagina moet behouden; gebruik de standaard 'flow'-modus wanneer deze zich moet laten doorstromen als een normaal tekstverwerkingsdocument.
  • Geef images: 'external' en een imageDir op MarkdownExportOptions door voor grote documenten, in plaats van de standaard inline-data-URI’s, om het Markdown-bestand zelf klein te houden.

Veelvoorkomende problemen

ProbleemOorzaakOplossing
ConvertToPdfA() rapporteert nog steeds passed: falseNiet elk probleem dat ConversionReport.unresolved opsomt, kan automatisch worden verholpen (bijv. ontbrekende ingebedde lettertypen of een ontbrekende /OutputIntent)Los de specifieke unresolved-regels handmatig op, voer vervolgens ConvertToPdfA() opnieuw uit
Live-document werd onverwacht gewijzigd na een PDF/A-conversiepogingConvertToPdfA() werd rechtstreeks op het werkdocument aangeroepen in plaats van op een kopieRoep het aan op een kopie gemaakt met Document.ExtractPages()
Markdown-export produceert één groot bestandDe standaard images: 'inline' embedt elke afbeelding als een data-URIGeef { images: 'external', imageDir: '...' } door om afbeeldingen als afzonderlijke bestanden te schrijven
DOCX-uitvoer verliest de oorspronkelijke paginalay-outDe standaard mode: 'flow' herformatteert de inhoud zoals een tekstverwerkerGeef { mode: 'textbox' } door om de geometrie van elke pagina te behouden

FAQ

Naar welke formaten kan een PDF worden geconverteerd?

HTML, Markdown en DOCX voor het volledige document (Document.ToHtml() / ToMarkdown() / ToDocx()); SVG en PNG per pagina (Page.ToSvg() / Page.ToImage()); plus TIFF en FDF/XFDF form-data export.

Wijzigt het converteren naar PDF/A mijn oorspronkelijke document?

Alleen als je ConvertToPdfA() er direct op toepast. Pas het toe op een duplicaat — bijvoorbeeld doc.ExtractPages(doc.Pages.map((_, i) => i + 1)) — om het originele document ongewijzigd te laten.

Hoe weet ik of een PDF/A-conversie daadwerkelijk geslaagd is?

Controleer ConversionReport.passed. applied geeft weer wat de conversie heeft gecorrigeerd, en unresolved toont wat niet kon worden opgelost — inspecteer unresolved zelfs wanneer passed true is.

Kan ik alleen de ingevulde formulier-veldwaarden exporteren, zonder de PDF zelf?

Ja — exportFdfFile() en exportXfdfFile() schrijven de huidige AcroForm veldwaarden naar een apart FDF- of XFDF-bestand; importFdfFile() / importXfdfFile() lezen ze terug in een document.


API Reference Samenvatting

Klasse/MethodeBeschrijving
Document.ToHtml() / Document.ToDocx() / Document.ToMarkdown()Render elke pagina naar een ander documentformaat
Page.ToSvg() / Page.ToImage()Render een enkele pagina naar SVG of PNG
DocxOptions / MarkdownExportOptions / ImageOptionsRenderopties per formaat
Document.ConvertToPdfA()Herstel een document naar een PDF/A-niveau en valideer opnieuw
ConversionReportHet conversieresultaat: applied, unresolved, passed
TiffExportOptions / encodeTiff()Exporteren naar TIFF
exportFdfFile() / exportXfdfFile() / importFdfFile() / importXfdfFile()Exporteer of importeer AcroForm veldwaarden als FDF/XFDF

Zie ook

 Nederlands