Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

For a server-side PDF from an HTML file, use DevExpress Office File API’s RichEditDocumentServer: load the document, then call ExportToPdf. The key production detail is asset resolution: if the HTML refers to external CSS or images, configure a custom IUriProvider so the server-side converter can locate them. For HTML already inside a RichEdit or ASPxHtmlEditor control, use that control’s export path instead; for a structured XtraReport, use Reporting’s PDF export.

Choose the DevExpress path that matches your source

“Convert HTML to PDF with DevExpress” can mean several different things. The best API depends on whether you have an HTML file, content in an editor, or a report definition. Choosing by source type avoids trying to use an editor-specific export method as a general-purpose HTML converter.

Source content DevExpress path Typical execution
An HTML file to convert in a job or service Office File API: RichEditDocumentServer.LoadDocument and ExportToPdf Server-side
Content being edited in RichEdit RichEdit client PDF export or configured server export Browser or server, depending on configuration
Content in an ASPxHtmlEditor HtmlEditorExportFormat.Pdf or the client PDF export command Web Forms control workflow
A structured XtraReport Reporting PDF export, such as ExportToPdf or ExportToPdfAsync Reporting application workflow

For a background job, API endpoint, or conversion of a file on the server, the Office File API route is the most direct documented workflow. The other options are useful when the source already belongs to the corresponding DevExpress control or reporting model.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Convert an HTML file on the server

Load the HTML document into RichEditDocumentServer, then export it as PDF. This is the core sequence in DevExpress’s documented example. DevExpress: Export HTML to PDF with RichEditDocumentServer.

#1 Best Overall
PDF Converter Ultimate - Convert PDF files into Word, Excel, PowerPoint and others - PDF converter software with OCR recognition compatible with Windows 11 / 10 / 8.1 / 8 / 7
  • Convert your PDF files into Word, Excel & Co. the easy way
  • Convert scanned documents thanks to our new 2022 OCR technology
  • Adjustable conversion settings
  • No subscription! Lifetime license!
  • Compatible with Windows 11, 10, 8.1, 7 - Internet connection required
using DevExpress.XtraRichEdit;

using var server = new RichEditDocumentServer();
server.LoadDocument("Documents/TextWithImages.htm");
server.ExportToPdf("Document_PDF.pdf");

The paths are examples: replace the input and output names with paths appropriate to your application. In a service, validate the input path and ensure the process can read the HTML and write the destination PDF. If an API accepts a user-supplied path or URL, validate it rather than passing untrusted input directly to file or network access.

External CSS and images

HTML may refer to stylesheets or images by URI. The converter runs in your application process, so those resources must be resolvable and reachable from that environment; access a browser has does not automatically mean the server can access it. DevExpress recommends a custom descendant of IUriProvider when external CSS or image URIs need handling. Override CreateCssUri or CreateImageUri as appropriate to provide the resource locations. See the DevExpress HTML-to-PDF guidance.

For a repeatable conversion pipeline, keep asset handling explicit: verify that linked resources are available to the process, decide how relative paths resolve, and test templates with the same fonts and assets used in production. A PDF can be generated successfully while still differing from the intended layout if a stylesheet, image, or font is missing.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Pagination and visual validation

HTML-to-PDF conversion is not a promise of pixel-identical browser rendering. Check page breaks, font availability, image sizing, and print-specific CSS against representative input documents. If page dimensions or orientation matter, include those checks in the application’s acceptance tests rather than relying on a single short sample.

Rank #2
Doxillion Free Document Converter – Converts DOCX, DOC, PDF, WPS and Many More Files Quickly [Download]
  • Convert over 50 document file formats.
  • Preview your files from Doxillion before converting them.
  • Use batch conversion to convert thousands of files at once.
  • Enjoy an easy-to-use, intuitive interface with a Drag and Drop file option.
  • Burn your converted or original files directly to disc.

Export PDF from RichEdit in an ASP.NET Core application

If the user is already editing a document in the RichEdit client, its exportToPdf method is usually more appropriate than reloading an unrelated HTML file through the server API. RichEdit exposes a PdfExporting event. Set e.handled = true to handle PDF generation in the browser; otherwise configure ExportUrl for server-side handling of the exported data. Consult the DevExpress ASP.NET Core RichEdit export documentation for the configuration used by your control version.

A client-side call can look like this:

richEdit.exportToPdf("document", {
  modifyPdfDocument: function (pdfDocument) {
    // Optional PDFKit post-processing.
  }
});

Client PDF export has dependencies beyond this call. DevExpress documents the need to provide available fonts and register pdfkit. Its PDF settings API also includes blobStream, pdfDocument, and pdfKitScriptUrl, plus convertImageToCompatibleFormat for converting images to JPEG or PNG when needed. Use the PDF export settings reference to match your application setup.

For downloading the generated file, RichEdit provides the downloadPdf helper. Callbacks can modify the PDF document or its pages before it is delivered. This path is suited to an edit-and-download interaction; a scheduled server conversion of an HTML file has a different source and should use the server workflow above.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Export PDF from ASPxHtmlEditor in Web Forms

For content held by the ASPxHtmlEditor control in a Web Forms application, use the editor’s PDF export API rather than treating the control method as a general converter for arbitrary files:

Rank #3
PDF Extra Ultimate | Complete PDF Reader and Editor | Create, Edit, Convert, Combine, Comment, Fill & Sign PDFs | Yearly License | 1 Windows PC & 2 Mobile Devices | 1 User
  • EDIT text, images & designs in PDF documents. ORGANIZE PDFs. Convert PDFs to Word, Excel & ePub.
  • READ and Comment PDFs – Intuitive reading modes & document commenting and mark up.
  • CREATE, COMBINE, SCAN and COMPRESS PDFs
  • FILL forms & Digitally Sign PDFs. PROTECT and Encrypt PDFs
  • 1 Year License for 1 Windows & 2 Mobile (Android and/or iOS) devices.
ASPxHtmlEditor1.Export(HtmlEditorExportFormat.Pdf, "MyFile");

The control can export to a stream or return a downloadable file. The client export command can also request PDF using Pdf. See ASPxHtmlEditor.Export documentation for the API details.

This is a focused option for editor content in Web Forms. It is not the general-purpose replacement for converting arbitrary HTML files in a modern ASP.NET Core service.

Export an XtraReport to PDF

If the input is a structured DevExpress XtraReport, use DevExpress Reporting’s PDF export methods, including ExportToPdf or ExportToPdfAsync. Reporting supports exporting from code and report-viewing workflows across its supported desktop and web platforms. See DevExpress Reporting PDF export. This is the appropriate route when report-specific layout, data binding, and viewer behavior are part of the job; it is not a substitute for loading a standalone HTML file.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Print mode is not the same as HTML-to-PDF conversion

RichEdit offers HTML and PDF print modes. HTML mode opens rendered markup in a browser tab and depends on the browser’s print settings. PDF mode generates a PDF first. DevExpress documents page-format and section-orientation limitations for HTML mode, so if those settings matter, review the RichEdit print documentation and validate the actual output. Choose PDF mode when the application needs a generated PDF rather than a browser print dialog.

Rank #4
PDF Extra Lifetime - Professional PDF Editor - Best Adobe Acrobat Pro Alternative - Lifetime License for Windows PC
  • Perfect Adobe Acrobat Pro alternative – lifetime license for Windows 10 and 11.
  • EDIT text, images, pages, hyperlinks, designs in PDF documents. ORGANIZE PDFs.
  • READ and Comment on PDFs – Intuitive reading modes & document commenting and mark up tools!
  • CREATE, COMBINE, SCAN and COMPRESS PDFs.
  • FILL forms & Digitally Sign PDFs. Work with Digital certificates

Troubleshoot common conversion problems

  • PDF is created, but styles are missing: Check that external CSS URIs resolve in the server environment. Implement an IUriProvider descendant and override CreateCssUri when required.
  • Images are absent: Confirm that image URIs can be reached by the process and that relative references resolve as intended. Use CreateImageUri in a custom provider when needed.
  • Client-side RichEdit export fails before producing a file: Check that pdfkit is registered and that the PDF settings include the required stream/document setup. Verify that the browser has the available fonts expected by the export path.
  • An image prevents client PDF export: Review the PDF settings’ convertImageToCompatibleFormat option to convert the image to JPEG or PNG where appropriate.
  • The PDF layout differs from browser output: Test fonts, pagination, page breaks, and print CSS with real templates. Do not assume HTML print mode and generated PDF mode share identical layout behavior.
  • Export works in a control but not for a standalone HTML file: Confirm that the chosen route matches the source. ASPxHtmlEditor exports its editor content; an arbitrary server-side HTML file belongs on the RichEditDocumentServer path.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Performance, reliability, and cost considerations

The documented APIs establish the conversion routes and dependencies, but they do not establish universal throughput, memory use, or fidelity benchmarks. For a service, measure representative document sizes and complexity in the deployment environment. Consider queueing long conversions, separating input validation from conversion, and cleaning up temporary files after delivery.

Reliability depends on treating resources as inputs to the conversion, not assumptions: check that the service can access CSS, images, and fonts; detect failed conversions; and test layouts after template or dependency changes. Do not infer rendering quality from a successful return alone.

DevExpress product pricing and licensing details are not included here; check the terms that apply to your edition and deployment before production use. The choice among server conversion, client export, Web Forms editor export, and Reporting should be based on the existing content model and required execution location, not on presumed speed or output equivalence.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Or skip the browser setup

If your real goal is a visual capture of a live web page, rather than a document produced through a DevExpress editor or report, ScreenshotNeo provides a screenshot API and MCP server. A single GET request can return PNG, JPEG, WebP, or PDF. This is a page-capture alternative, not a replacement for DevExpress document conversion when you need a PDF from an HTML file or structured report.

Best Value
Doxillion Free Document Converter for Mac – Converts DOCX, DOC, PDF, WPS and Many More Files Quickly [Download]
  • Convert over 50 document file formats.
  • Preview your files from Doxillion before converting them.
  • Use batch conversion to convert thousands of files at once.
  • Enjoy an easy-to-use, intuitive interface with a Drag and Drop file option.
  • Burn your converted or original files directly to disc.

cURL example, adapted to the page you want to capture:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

See the ScreenshotNeo documentation for the API and available options. Cookie banners are accepted and removed before capture, along with 60+ known consent platforms, newsletter popups, and chat widgets; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing, with response headers identifying the page verdict and billing status. An MCP server exposes take_screenshot, get_page_info, and capture_pdf for AI agents. The free plan includes 1,000 shots per month without a card; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo’s free plan.

Frequently Asked Questions

Can RichEditDocumentServer convert an HTML file without opening a browser?

Yes. The server-side workflow loads the HTML with `LoadDocument` and writes the PDF with `ExportToPdf`.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Should I use ASPxHtmlEditor export for arbitrary HTML in ASP.NET Core?

No. ASPxHtmlEditor’s PDF export is for content in that Web Forms control. For a server-side HTML file, use the Office File API route.

Does ScreenshotNeo replace DevExpress for converting an HTML document?

No. ScreenshotNeo captures live web pages; use DevExpress when you need the document conversion or report-specific workflow described above.

Quick Recap

Bestseller No. 1
PDF Converter Ultimate - Convert PDF files into Word, Excel, PowerPoint and others - PDF converter software with OCR recognition compatible with Windows 11 / 10 / 8.1 / 8 / 7
PDF Converter Ultimate - Convert PDF files into Word, Excel, PowerPoint and others - PDF converter software with OCR recognition compatible with Windows 11 / 10 / 8.1 / 8 / 7
Convert your PDF files into Word, Excel & Co. the easy way; Convert scanned documents thanks to our new 2022 OCR technology
$29.99
Bestseller No. 2
Doxillion Free Document Converter – Converts DOCX, DOC, PDF, WPS and Many More Files Quickly [Download]
Doxillion Free Document Converter – Converts DOCX, DOC, PDF, WPS and Many More Files Quickly [Download]
Convert over 50 document file formats.; Preview your files from Doxillion before converting them.
Bestseller No. 3
PDF Extra Ultimate | Complete PDF Reader and Editor | Create, Edit, Convert, Combine, Comment, Fill & Sign PDFs | Yearly License | 1 Windows PC & 2 Mobile Devices | 1 User
PDF Extra Ultimate | Complete PDF Reader and Editor | Create, Edit, Convert, Combine, Comment, Fill & Sign PDFs | Yearly License | 1 Windows PC & 2 Mobile Devices | 1 User
READ and Comment PDFs – Intuitive reading modes & document commenting and mark up.; CREATE, COMBINE, SCAN and COMPRESS PDFs
$83.88
Bestseller No. 4
PDF Extra Lifetime - Professional PDF Editor - Best Adobe Acrobat Pro Alternative - Lifetime License for Windows PC
PDF Extra Lifetime - Professional PDF Editor - Best Adobe Acrobat Pro Alternative - Lifetime License for Windows PC
Perfect Adobe Acrobat Pro alternative – lifetime license for Windows 10 and 11.; EDIT text, images, pages, hyperlinks, designs in PDF documents. ORGANIZE PDFs.
$99.99
Bestseller No. 5
Doxillion Free Document Converter for Mac – Converts DOCX, DOC, PDF, WPS and Many More Files Quickly [Download]
Doxillion Free Document Converter for Mac – Converts DOCX, DOC, PDF, WPS and Many More Files Quickly [Download]
Convert over 50 document file formats.; Preview your files from Doxillion before converting them.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.