1. Home
  2. /
  3. GroupDocs.Conversion.LowCode
  4. /
  5. Developer Guide
  6. /
  7. Using DOCX to PDF Converter

Using DOCX to PDF Converter

On this page

This topic shows how to use the DocxToPdfConverter with examples that demonstrate common use cases for converting DOCX files to PDF.

Prerequisites

Refer to the Developer Guide to learn how to set up your environment and run code examples in this section.

You can also check two related topics on Loading Source Documents and Saving Converted Documents to learn how to specify intput and output documents.

Basic Example

The following example shows the most common use case for converting DOCX document to PDF. The source DOCX file is loaded from a current folder. The converted file is saved to the same folder.

using System;
using GroupDocs.Conversion.LowCode;

// Load license keys
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

// Apply the license
License.Set(publicKey, privateKey);

// Create a converter for the DOCX file
var converter = new DocxToPdfConverter("business-plan.docx");

// Convert DOCX as PDF
converter.Convert("business-plan.pdf");
Imports System
Imports GroupDocs.Conversion.LowCode

Module Program
    Sub Main()
        ' Load license keys
        Dim publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        ' Apply the license
        License.Set(publicKey, privateKey)

        ' Create a converter from file path
        Dim converter As New DocxToPdfConverter("business-plan.docx")

        ' Convert DOCX to PDF
        converter.Convert("business-plan.pdf")
    End Sub
End Module
open System
open GroupDocs.Conversion.LowCode

[<EntryPoint>]
let main _ =
    // Load license keys
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    // Apply the license
    License.Set(publicKey, privateKey)

    // Create a converter from file path
    let converter = new DocxToPdfConverter("business-plan.docx")

    // Convert DOCX to PDF
    converter.Convert("business-plan.pdf")
    0

Sample input file: Download business-plan.docx

Expected output: Download business-plan.pdf

DOCX Load Options

This section covers only the main scenarious you also reffer to the API references for the WordProcessingLoadOptions for a complete list of options that you can specify.

Convert Protected DOCX to PDF

The following example shows how to convert protected DOCX file and save it to unprotected PDF file.

In case you do not specify password for protected document PasswordRequiredException is going to be thrown.

using System;
using GroupDocs.Conversion.LowCode;

// Load license keys
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

// Apply license
License.Set(publicKey, privateKey);

// Provide password through load options
var converter = new DocxToPdfConverter("protected.docx", options =>
{
    options.Password = "12345";
});

// Convert DOCX to PDF
converter.Convert("not-protected.pdf");
Imports GroupDocs.Conversion.LowCode

Module Program
    Sub Main()
        ' Load license keys
        Dim publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        ' Apply license
        License.Set(publicKey, privateKey)

        ' Provide password through load options
        Dim converter As New DocxToPdfConverter("protected.docx", Sub(options)
            options.Password = "12345"
        End Sub)

        ' Convert DOCX to PDF
        converter.Convert("not-protected.pdf")
    End Sub
End Module
open System
open GroupDocs.Conversion.LowCode

[<EntryPoint>]
let main _ =
    // Load license keys
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    // Apply the license
    License.Set(publicKey, privateKey)

    // Provide password through load options
    let converter = new DocxToPdfConverter("protected.docx", fun options ->
        options.Password <- "12345"
    )
    
    // Convert DOCX to PDF
    converter.Convert("not-protected.pdf")
    0

Sample input: Download protected.docx (Password: 12345)

Expected output: Download not-protected.pdf

Convert DOCX with Tracked Changes to PDF

By default, tracked changes are converted and displayed in the output PDF document. See this tracked-changes.pdf that includes the list of changes.

The following example shows how to convert a DOCX file that contains tracked changes and save a clean PDF file without those revisions.

using System;
using GroupDocs.Conversion.LowCode;

// Load license keys
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

// Apply license
License.Set(publicKey, privateKey);

// Hide tracked changes through load options
var converter = new DocxToPdfConverter("tracked-changes.docx", options =>
{
    options.HideWordTrackedChanges = true;
});

// Convert DOCX to PDF
converter.Convert("clean.pdf");
Imports GroupDocs.Conversion.LowCode

Module Program
    Sub Main()
        ' Load license keys
        Dim publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        ' Apply license
        License.Set(publicKey, privateKey)

        ' Hide tracked changes through load options
        Dim converter As New DocxToPdfConverter("tracked-changes.docx", Sub(options)
            options.HideWordTrackedChanges = True
        End Sub)

        ' Convert DOCX to PDF
        converter.Convert("clean.pdf")
    End Sub
End Module
open System
open GroupDocs.Conversion.LowCode

[<EntryPoint>]
let main _ =
    // Load license keys
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    // Apply license
    License.Set(publicKey, privateKey)

    // Hide tracked changes through load options
    let converter = new DocxToPdfConverter("tracked-changes.docx", fun options ->
        options.HideWordTrackedChanges <- true
    )

    // Convert DOCX to PDF
    converter.Convert("clean.pdf")
    0

Sample input: Download tracked-changes.docx (Contains revisions)

Expected output: Download clean.pdf (Tracked changes hidden)

Convert DOCX with Comments to PDF without Comments

By default, comments are added to the output PDF file, see this with-comments.pdf as an example of PDF file with comments.

The following example shows how to convert a DOCX file that contains comments and save a PDF file without comments.

using System;
using GroupDocs.Conversion.LowCode;
using GroupDocs.Conversion.Options.Load;

// Load license keys
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

// Apply license
License.Set(publicKey, privateKey);

// Hide comments using CommentDisplayMode
var converter = new DocxToPdfConverter("with-comments.docx", options =>
{
    options.CommentDisplayMode = WordProcessingCommentDisplay.Hidden;
});

// Convert DOCX to PDF
converter.Convert("no-comments.pdf");
Imports GroupDocs.Conversion.LowCode
Imports GroupDocs.Conversion.Options.Load

Module Program
    Sub Main()
        ' Load license keys
        Dim publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        ' Apply license
        License.Set(publicKey, privateKey)

        ' Hide comments using CommentDisplayMode
        Dim converter As New DocxToPdfConverter("with-comments.docx", Sub(options)
            options.CommentDisplayMode = WordProcessingCommentDisplay.Hidden
        End Sub)

        ' Convert DOCX to PDF
        converter.Convert("no-comments.pdf")
    End Sub
End Module
open System
open GroupDocs.Conversion.LowCode
open GroupDocs.Conversion.Options.Load

[<EntryPoint>]
let main _ =
    // Load license keys
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    // Apply license
    License.Set(publicKey, privateKey)

    // Hide comments using CommentDisplayMode
    let converter = new DocxToPdfConverter("with-comments.docx", fun options ->
        options.CommentDisplayMode <- WordProcessingCommentDisplay.Hidden
    )

    // Convert DOCX to PDF
    converter.Convert("no-comments.pdf")
    0

Sample input: Download with-comments.docx (Contains comments)

Expected output: Download no-comments.pdf (Comments hidden)

PDF Convert Options

The examples in this section shows how you can adjust the output using PdfConvertOptions.

Convert Specific DOCX Pages to PDF

To convert only a portion of the document instead of all pages. You can specify which pages to include in the output PDF using the Pages property of PdfConvertOptions class.

As an alternative you can use PageNumber to specify the page number to start conversion from and PagesCount to set number of pages to convert starting from PageNumber.

The following example shows how to convert the first three pages of a DOCX file to PDF:

using System;
using System.Collections.Generic;
using GroupDocs.Conversion.LowCode;

// Load license keys
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

// Apply license
License.Set(publicKey, privateKey);

// Create the converter
var converter = new DocxToPdfConverter("business-plan.docx");

// Save first three pages to PDF
converter.Convert("pages-1-2-3.pdf", (convertOptions) => {
    convertOptions.Pages = new List<int> { 1, 2, 3 };
});
Imports System
Imports System.Collections.Generic
Imports GroupDocs.Conversion.LowCode

Module Program
    Sub Main()
        ' Load license keys
        Dim publicKey As String = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey As String = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        ' Apply license
        License.Set(publicKey, privateKey)

        ' Create the converter
        Dim converter As New DocxToPdfConverter("business-plan.docx")

        ' Save first three pages to PDF
        converter.Convert("pages-1-2-3.pdf", Sub(convertOptions)
                                                convertOptions.Pages = New List(Of Integer) From {1, 2, 3}
                                            End Sub)
    End Sub
End Module
open System
open System.Collections.Generic
open GroupDocs.Conversion.LowCode

[<EntryPoint>]
let main argv =
    // Load license keys
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    // Apply license
    License.Set(publicKey, privateKey)

    // Create the converter
    let converter = new DocxToPdfConverter("business-plan.docx")

    // Save first three pages to PDF
    converter.Convert("pages-1-2-3.pdf", fun convertOptions ->
        convertOptions.Pages <- List<int>([1; 2; 3])
    )

    0 // return exit code

Sample input: Download business-plan.docx

Expected output: Download pages-1-2-3.pdf

Convert DOCX to Password-Protected PDF

You can protect the output PDF with a password by setting the Password property in PdfConvertOptions class.

using System;
using GroupDocs.Conversion.LowCode;

// Load license keys
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

// Apply license
License.Set(publicKey, privateKey);

// Create the converter
var converter = new DocxToPdfConverter("business-plan.docx");

// Convert to password-protected PDF
converter.Convert("protected.pdf", convertOptions =>
{
    convertOptions.Password = "12345";
});
Imports GroupDocs.Conversion.LowCode

Module Program
    Sub Main()
        ' Load license keys
        Dim publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        ' Apply license
        License.Set(publicKey, privateKey)

        ' Create the converter
        Dim converter As New DocxToPdfConverter("business-plan.docx")

        ' Convert to password-protected PDF
        converter.Convert("protected.pdf", Sub(convertOptions)
            convertOptions.Password = "12345"
        End Sub)
    End Sub
End Module
open System
open GroupDocs.Conversion.LowCode

[<EntryPoint>]
let main _ =
    // Load license keys
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    // Apply license
    License.Set(publicKey, privateKey)

    // Create the converter
    let converter = new DocxToPdfConverter("business-plan.docx")

    // Convert to password-protected PDF
    converter.Convert("protected.pdf", fun convertOptions ->
        convertOptions.Password <- "12345"
    )

    0

Sample input: Download business-plan.docx

Expected output: Download protected.pdf (Password: 12345)

On this page