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 vanuitDocument.ExtractPages()), nooit op het live-document dat je nog moet opslaan zonder conversie. - Controleer
ConversionReport.unresolvedzelfs wanneerpassedtrueis voor een lossere validatieniveau — sommige herstelacties lossen pas volledig op bij een strenger niveau. - Gebruik
mode: 'textbox'opDocxOptionswanneer 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 eenimageDiropMarkdownExportOptionsdoor voor grote documenten, in plaats van de standaard inline-data-URI’s, om het Markdown-bestand zelf klein te houden.
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
ConvertToPdfA() rapporteert nog steeds passed: false | Niet 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-conversiepoging | ConvertToPdfA() werd rechtstreeks op het werkdocument aangeroepen in plaats van op een kopie | Roep het aan op een kopie gemaakt met Document.ExtractPages() |
| Markdown-export produceert één groot bestand | De standaard images: 'inline' embedt elke afbeelding als een data-URI | Geef { images: 'external', imageDir: '...' } door om afbeeldingen als afzonderlijke bestanden te schrijven |
| DOCX-uitvoer verliest de oorspronkelijke paginalay-out | De standaard mode: 'flow' herformatteert de inhoud zoals een tekstverwerker | Geef { 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/Methode | Beschrijving |
|---|---|
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 / ImageOptions | Renderopties per formaat |
Document.ConvertToPdfA() | Herstel een document naar een PDF/A-niveau en valideer opnieuw |
ConversionReport | Het conversieresultaat: applied, unresolved, passed |
TiffExportOptions / encodeTiff() | Exporteren naar TIFF |
exportFdfFile() / exportXfdfFile() / importFdfFile() / importXfdfFile() | Exporteer of importeer AcroForm veldwaarden als FDF/XFDF |