Convert Word to PDF using Syncfusion® Word (DocIO) library

9 Dec 202412 minutes to read

Syncfusion® Word library (DocIO) allows you to convert Word document to PDF within a few lines of code in .NET applications and also it does not require Adobe and Microsoft Word application to be installed in the machine. Using this, you can create an input Word document from scratch or load an existing Word document and then easily convert to PDF.

The Syncfusion® Word to PDF converter offers high versatility and seamless performance across various .NET platforms, including Windows Forms, WPF, ASP.NET, ASP.NET MVC, ASP.NET Core, Blazor, Xamarin, WinUI, .NET MAUI. Also, in different environments like Azure, AWS, Google Cloud, Linux, Docker, and macOS.

Key Features

  • Ability to embed fonts within the PDF for consistent display.
  • Support for converting Word documents to PDF/UA (Section 508 compliant).
  • Support for converting Word documents to PDF/A with various PDF conformance levels for long-term archiving and standardization.
  • Ability to preserve Word document form fields as PDF forms, allowing the creation of editable PDFs.
  • Convert Word headings to PDF bookmarks, generating PDF documents with bookmarks based on Word document paragraph styles and outline levels.
  • Support for font substitution when fonts are not available during Word to PDF conversion.
  • Set fallback fonts for characters when glyphs are not available.
  • Ability to optimize identical images to reduce PDF file size.
  • Option to include or exclude alternate chunks during Word to PDF conversion.
  • Ability to use custom dictionaries for text hyphenation in the converted PDF.
  • Support for preserving revision marks of tracked changes in the converted PDF.
  • Option to toggle between preserving or excluding comments during Word to PDF conversions.
  • Option to show warnings for any unsupported elements during conversion.

Assemblies and NuGet packages required

Refer to the following links for assemblies required based on platforms to convert the Word document to PDF.

To quickly start converting a Word document to a PDF, please check out this video:

Convert Word to PDF

The following namespaces are required to compile the code:

NOTE

Refer to the appropriate tabs in the code snippets section: C# [Cross-platform] for ASP.NET Core, Blazor, Xamarin, UWP, .NET MAUI, WinUI, and C# [Windows-specific] or VB.NET [Windows-specific] for WinForms, WPF, ASP.NET and ASP.NET MVC applications.

using Syncfusion.DocIO;
using Syncfusion.DocIO.DLS;
using Syncfusion.DocIORenderer;
using Syncfusion.Pdf;
using Syncfusion.DocIO;
using Syncfusion.DocIO.DLS;
using Syncfusion.OfficeChart;
using Syncfusion.DocToPDFConverter;
using Syncfusion.OfficeChartToImageConverter;
using Syncfusion.Pdf;
Imports Syncfusion.DocIO
Imports Syncfusion.DocIO.DLS
Imports Syncfusion.OfficeChart
Imports Syncfusion.DocToPDFConverter
Imports Syncfusion.OfficeChartToImageConverter
Imports Syncfusion.Pdf

The following code example illustrates how to convert a Word document into PDF document.

//Open the Word document file stream.
using (FileStream inputStream = new FileStream("Template.docx", FileMode.Open, FileAccess.Read))
{
    //Loads an existing Word document.
    using (WordDocument wordDocument = new WordDocument(inputStream, FormatType.Automatic))
    {
        //Creates an instance of DocIORenderer.
        using (DocIORenderer renderer = new DocIORenderer())
        {
            //Converts Word document into PDF document.
            using (PdfDocument pdfDocument = renderer.ConvertToPDF(wordDocument))
            {
                //Saves the PDF file to file system.    
                using (FileStream outputStream = new FileStream("Output.pdf", FileMode.Create, FileAccess.ReadWrite))
                {
                    pdfDocument.Save(outputStream);
                }
            }
        }
    }
}
//Loads an existing Word document
WordDocument wordDocument = new WordDocument("Template.docx", FormatType.Docx);
//Initializes the ChartToImageConverter for converting charts during Word to pdf conversion
wordDocument.ChartToImageConverter = new ChartToImageConverter();
//Creates an instance of the DocToPDFConverter
DocToPDFConverter converter = new DocToPDFConverter();
//Converts Word document into PDF document
PdfDocument pdfDocument = converter.ConvertToPDF(wordDocument);
//Saves the PDF file 
pdfDocument.Save("WordtoPDF.pdf");
//Closes the instance of document objects
pdfDocument.Close(true);
wordDocument.Close();
'Loads an existing Word document
Dim wordDocument As New WordDocument("Template.docx", FormatType.Docx)
'Initializes the ChartToImageConverter for converting charts during Word to pdf conversion
wordDocument.ChartToImageConverter = New ChartToImageConverter()
'Creates an instance of the DocToPDFConverter
Dim converter As New DocToPDFConverter()
'Converts Word document into PDF document
Dim pdfDocument As PdfDocument = converter.ConvertToPDF(wordDocument)
'Saves the PDF file 
pdfDocument.Save("WordtoPDF.pdf")
'Closes the instance of document objects
pdfDocument.Close(True)
wordDocument.Close()

By executing the program, you will get the output PDF as follows.

Word to PDF conversion.

You can download a complete working sample from GitHub.

TIPS

For troubleshooting issues in the .NET Word Library (DocIO), refer this article that provides comprehensive guidance on resolving common problems.

NOTE

  1. For .NET Framework, creating an instance of the ChartToImageConverter class is mandatory to convert the charts present in the Word to PDF. Otherwise, the charts are not preserved in the converted PDF. Whereas this is not necessary for .NET Core, as ChartToImageConverter is initialized internally in Syncfusion.DocIORenderer.Portable assembly.
  2. Total number of pages in the converted PDF may vary based on unsupported elements in the input Word document.
  3. “DocIO supports Word to PDF conversion in UWP application using DocIORenderer.” For further information, please refer here

Supported File formats

The .NET Word Library (DocIO) supports below formats to convert into PDF.

  • DOC, DOCX, Word Processing XML (2003 & 2007), DOT, DOTX, DOCM, and DOTM
  • RTF
  • Text
  • Markdown
  • HTML

Word to PDF conversion in Linux OS

In Linux OS, you can perform the Word to PDF conversion using .NET Core (Targeting .netcoreapp) application. For further information, click here.

Frequently Asked Questions

Customization settings

The Essential® DocIO provides settings while performing Word to PDF conversion mentioned below,

Fast rendering

This setting allows you to convert PDF faster by using direct PDF rendering approach rather than EMF rendering approach. For further information, click here.

Embedding fonts

You can customize the TrueType fonts embedding in two ways as follows:

Accessible PDF document

This setting allows you to determine whether to preserve document structured tags in the converted PDF document for accessibility (508 compliance) support. For further information, click here.

Word document headings to PDF bookmarks

This setting allows you to determine whether to preserve Word document headings (i.e., paragraph with heading style and outline level) as bookmarks in the converted PDF document. For further information, click here.

Word document form field to PDF form field.

This setting allows you to determine whether to preserve Word document form fields (Text form field, Checkbox form field and Drop-down form field) as PDF form fields in the converted PDF document. This features helps in creating fillable PDF forms from Word document. For further information, click here.

Image quality

This setting allows you to determine the quality of the charts and JPEG images in the converted PDF document. For further information, click here.

Recreate Nested Metafile

This setting allows you to regenerate the nested EMF images present in the Word document during PDF conversion. For further information, click here.

Identical image optimization

This setting reduces the Main Memory usage in Word to PDF conversion by reusing the identical images. For further information, click here.

PDF Conformance Level

This setting allows you to set the PDF conformance level. For further information, click here.

Enable Alternate Chunks

In the Word document, another Word documents are embedded in it and referred as AltChunks. This setting allows you to include the alternate chunks while converting Word to PDF conversion. For further information, click here.

Complex Script Text

This setting allows you to preserve the complex script text in the converted PDF document. For further information, click here.

Hyphenation in Word-to-PDF conversion

Essential® DocIO now allows hyphenating text in a Word document while converting it to PDF format based on the given language dictionaries. For further information, click here.

Track changes in Word-to-PDF conversion

You can preserve revision marks in a generated PDF document when converting Word documents with tracked changes or revisions. For further information, click here.

Comments in Word-to-PDF conversion

You can preserve comments balloon in a generated PDF when converting Word documents with comments. Also you can customize how comments balloon color appears in a generated PDF. For further information, click here.

Preserve Ole Equation as bitmap image

You can preserve Ole Equation as bitmap image in the converted PDF document. For further information, click here.

Restrict all permission in a PDF document

You can restrict all the permission in a PDF document using PdfPermissionsFlags. For further information, click here.

Font Substitution

When the necessary fonts used in the Word document has not been installed in the production machine, then Essential® DocIO uses the ”Microsoft Sans Serif” as default font for rendering the text. This leads to preservation difference in generated PDF as each font has different glyphs for characters.

To avoid this, the Essential® DocIO library allows you to set an alternate font for the missing font used in the Word document. For further information, click here.

Fallback fonts

During Word to PDF conversions, if a glyph of the input text is unavailable in the specified font, the text will not be rendered properly. To address this, the Syncfusion® Word (DocIO) library allows users to specify fallback fonts. When a glyph is missing, the library will use one of the fallback fonts to render the text correctly in the output PDF document. For further information, click here.

Unsupported elements in Word to PDF conversion

Refer here to know about unsupported elements in Word to PDF conversion.

Show Warning for Unsupported Elements

When converting a Word document to a PDF, the presence of unsupported elements in the input Word document can lead to preservation issues in the converted PDF. For further information, click here.

Online Demo

  • Explore how to convert a Word document to PDF using the .NET Word Library (DocIO) in a live demo here.
  • See how to convert a Word document to PDF/UA using the .NET Word Library (DocIO) in a live demo here.
  • See how to convert a Word document to PDF/A using the .NET Word Library (DocIO) in a live demo here.

See Also