# Render web documents as PDF, PNG, and JPEG files This topic describes how to use the GroupDocs.Viewer .NET API (C#) to convert web documents to PDF, PNG, and JPEG formats. [GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render web documents as PDF, PNG, and JPEG files. Use this library to view web files within your .NET application. To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a web document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to PDF or image format. These methods allow you to render the entire document or specific pages. {{< button style="primary" link="https://products.groupdocs.app/viewer/web" >}} {{< icon "gdoc_person" >}} View web files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}} ## Supported web file formats GroupDocs.Viewer supports the following web file formats: * [Hypertext Markup Language Format](https://docs.fileformat.com/web/html/) (.HTML / .HTM) * [MIME HTML Format](https://docs.fileformat.com/web/mhtml/) (.MHTML) * [MHTML Web Archive](https://docs.fileformat.com/web/mht/) (.MHT) * [Compiled HTML Help Format](https://docs.fileformat.com/web/chm/) (.CHM) GroupDocs.Viewer can detect the document format automatically by analyzing file contents. ## Render web documents as PDF Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a web file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}). {{< tabs "render-web-to-pdf">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("groupdocs-documentation.mhtml")) { // Create a PDF file for the document. // Specify the PDF file name. var viewOptions = new PdfViewOptions("output.pdf"); viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("groupdocs-documentation.mhtml") ' Create a PDF file for the document. ' Specify the PDF file name. Dim viewOptions = New PdfViewOptions("output.pdf") viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "groupdocs-documentation.mhtml" >}} {{< tab-text >}} `groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "output.pdf" >}} ```text Binary file (PDF, 46 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderWebToPdf/output.pdf) {{< /tab >}} {{< /tabs >}} ## Render web documents as PNG Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a web file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels. {{< tabs "render-web-to-png">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("groupdocs-documentation.mhtml")) { // Convert the web file to PNG. // {0} is replaced with the page numbers in the output image names. var viewOptions = new PngViewOptions("output_{0}.png"); viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("groupdocs-documentation.mhtml") ' Convert the web file to PNG. ' {0} is replaced with the page numbers in the output image names. Dim viewOptions = New PngViewOptions("output_{0}.png") viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "groupdocs-documentation.mhtml" >}} {{< tab-text >}} `groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "render-web-to-png.zip" >}} ```text output_1.png (27 KB) output_2.png (25 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderWebToPng/render-web-to-png.zip) {{< /tab >}} {{< /tabs >}} ## Render web documents as JPEG Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a web file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels. {{< tabs "render-web-to-jpg">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("groupdocs-documentation.mhtml")) { // Convert the web file to JPEG. // {0} is replaced with the page numbers in the output image names. var viewOptions = new JpgViewOptions("output_{0}.jpg"); viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("groupdocs-documentation.mhtml") ' Convert the web file to JPEG. ' {0} is replaced with the page numbers in the output image names. Dim viewOptions = New JpgViewOptions("output_{0}.jpg") viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "groupdocs-documentation.mhtml" >}} {{< tab-text >}} `groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "render-web-to-jpg.zip" >}} ```text output_1.jpg (43 KB) output_2.jpg (36 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderWebToJpg/render-web-to-jpg.zip) {{< /tab >}} {{< /tabs >}} ## Convert CHM files to HTML [CHM](https://docs.fileformat.com/web/chm/) is a Microsoft proprietary online help format that is often used for software documentation. With GroupDocs.Viewer, you can convert a CHM file to HTML to display this file in a web browser. To do this, create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). ### Create an HTML file with embedded resources To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name. {{< tabs "render-chm-to-html">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("sample.chm")) { // Convert the CHM file to HTML. // {0} is replaced with the page numbers in the output file names. var viewOptions = HtmlViewOptions.ForEmbeddedResources("chm_result_{0}.html"); // Enable the following option to display all CHM content on a single HTML page. // options.RenderToSinglePage = true; viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("sample.chm") ' Convert the CHM file to HTML. ' {0} is replaced with the page numbers in the output file names. Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("chm_result_{0}.html") ' Enable the following option to display all CHM content on a single HTML page. ' options.RenderToSinglePage = true; viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "sample.chm" >}} {{< tab-text >}} `sample.chm` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/sample.chm) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "render-chm-to-html.zip" >}} ```text chm_result_1.html (86 KB) chm_result_10.html (84 KB) chm_result_100.html (99 KB) chm_result_101.html (89 KB) chm_result_102.html (101 KB) chm_result_103.html (98 KB) chm_result_104.html (120 KB) chm_result_105.html (114 KB) chm_result_106.html (81 KB) chm_result_107.html (75 KB) [TRUNCATED] (123 files total) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderChmToHtml/render-chm-to-html.zip) {{< /tab >}} {{< /tabs >}} ### Create an HTML file with external resources If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters: * The output file path format * The path format for the folder with external resources * The resource URL format {{< tabs "render-chm-to-html-external">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("sample.chm")) { // Convert the CHM file to HTML. // Specify the output file names and location of external resources. // {0} and {1} are replaced with the current page number and resource name, respectively. var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}"); viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("sample.chm") ' Convert the CHM file to HTML. ' Specify the output file names and location of external resources. ' {0} and {1} are replaced with the current page number and resource name, respectively. Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}") viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "sample.chm" >}} {{< tab-text >}} `sample.chm` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/sample.chm) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "render-chm-to-html-external.zip" >}} ```text page_1.html (30 KB) page_10.html (17 KB) page_100.html (16 KB) page_100/resource_100_f.woff (12 KB) page_100/resource_100_f1.woff (16 KB) page_100/resource_100_f2.woff (12 KB) page_100/resource_100_f3.woff (7 KB) page_100/resource_100_f4.woff (15 KB) page_100/resource_100_s.css (2 KB) page_101.html (17 KB) [TRUNCATED] (713 files total) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderChmToHtmlExternal/render-chm-to-html-external.zip) {{< /tab >}} {{< /tabs >}} ## Specify rendering options GroupDocs.Viewer supports the [WebDocumentOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions) class that allows you to specify different options for rendering web files. To access these options, use the [WebDocumentOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/webdocumentoptions) property for one of the following classes (depending on the output file format): * [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) * [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) * [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions) * [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) ### Adjust page margins Use the following properties to specify the size of page margins in the output files when you convert your web documents to HTML, PDF, and image formats: * [WebDocumentOptions.TopMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/topmargin)---Specifies the distance (in points) between the top edge of the page and the top boundary of the body text. The default value is 72 points. * [WebDocumentOptions.BottomMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/bottommargin)---Specifies the distance (in points) between the bottom edge of the page and the bottom boundary of the body text. The default value is 72 points. * [WebDocumentOptions.LeftMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/leftmargin)---Specifies the distance (in points) between the left edge of the page and the left boundary of the body text. The default value is 5 points. * [WebDocumentOptions.RightMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/rightmargin)---Specifies the distance (in points) between the right edge of the page and the right boundary of the body text. The default value is 5 points. The example below converts a web document to PDF and specifies page margins for the output file. {{< tabs "render-web-with-margins">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("groupdocs-documentation.mhtml")) { // Convert the document to PDF. var viewOptions = new PdfViewOptions("output.pdf"); // Specify the size of page margins in points. viewOptions.WebDocumentOptions.LeftMargin = 40; viewOptions.WebDocumentOptions.RightMargin = 40; viewOptions.WebDocumentOptions.TopMargin = 40; viewOptions.WebDocumentOptions.BottomMargin = 40; viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("groupdocs-documentation.mhtml") ' Convert the document to PDF. Dim viewOptions = New PdfViewOptions("output.pdf") ' Specify the size of page margins in points. viewOptions.WebDocumentOptions.LeftMargin = 40 viewOptions.WebDocumentOptions.RightMargin = 40 viewOptions.WebDocumentOptions.TopMargin = 40 viewOptions.WebDocumentOptions.BottomMargin = 40 viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "groupdocs-documentation.mhtml" >}} {{< tab-text >}} `groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "output.pdf" >}} ```text Binary file (PDF, 46 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderWebWithMargins/output.pdf) {{< /tab >}} {{< /tabs >}} ### Set the output page size GroupDocs.Viewer allows you to specify page size for the output file when you convert your web document to another format. Assign a [PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pagesize) enumeration member to the [WebDocumentOptions.PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/pagesize) property to select one of the predefined page sizes (Letter, Ledger, A0, A1, A2, A3, or A4). The following example specifies page size for the output PDF file: {{< tabs "render-web-with-page-size">}} {{< tab "C#" >}} ```csharp using GroupDocs.Viewer; using GroupDocs.Viewer.Options; // ... using (var viewer = new Viewer("groupdocs-documentation.mhtml")) { // Convert the document to PDF. var viewOptions = new PdfViewOptions("output.pdf"); // Specify the page size. viewOptions.WebDocumentOptions.PageSize = PageSize.A3; viewer.View(viewOptions); } ``` {{< /tab >}} {{< tab "VB.NET">}} ```vb Imports GroupDocs.Viewer Imports GroupDocs.Viewer.Options ' ... Module Program Sub Main(args As String()) Using viewer = New Viewer("groupdocs-documentation.mhtml") ' Convert the document to PDF. Dim viewOptions = New PdfViewOptions("output.pdf") ' Specify the page size. viewOptions.WebDocumentOptions.PageSize = PageSize.A3 viewer.View(viewOptions) End Using End Sub End Module ``` {{< /tab >}} {{< tab "groupdocs-documentation.mhtml" >}} {{< tab-text >}} `groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "output.pdf" >}} ```text Binary file (PDF, 45 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/net/_output_files/rendering-basics/render-web-documents/RenderWebWithPageSize/output.pdf) {{< /tab >}} {{< /tabs >}} ## Web documents rendering demo The [View HTML files online](https://products.groupdocs.app/viewer/html) app is available to test and preview rendering output for HTML and other document formats.