Convert Word document to PDF in Linux

24 Feb 20258 minutes to read

Syncfusion® DocIO is a .NET Core Word library used to create, read, edit, and convert Word documents programmatically without Microsoft Word or interop dependencies. Using this library, you can convert a Word document to PDF in .NET Core application on Linux.

Steps to convert a Word document to PDF in .NET Core application on Linux

Prerequisites:

  • Visual Studio 2022.
  • Install .NET 8 SDK or later.

Step 1: Execute the following command in Linux terminal to create a new .NET Core Console application.

dotnet new console

Create .NET Core console application on Linux

Step 2: Install the following Nuget packages in your application from Nuget.org by execute the following command.

dotnet add package Syncfusion.DocIORenderer.Net.Core -v 22.1.34 -s https://www.nuget.org/
dotnet add package SkiaSharp.NativeAssets.Linux -v 3.116.1 -s https://www.nuget.org/
dotnet add package HarfBuzzSharp.NativeAssets.Linux -v 8.3.0.1 -s https://www.nuget.org/

NOTE

  1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add “Syncfusion.Licensing” assembly reference and include a license key in your projects. Please refer to this link to know about registering Syncfusion® license key in your applications to use our components.
  2. If you are using prior to v23.1.40 release, please refer here to know about how to perform Word to PDF conversion in Linux.

Step 3: Add the following Namespaces in Program.cs file.

using Syncfusion.DocIO;
using Syncfusion.DocIO.DLS;
using Syncfusion.DocIORenderer;
using Syncfusion.Pdf;

Step 4: Add the following code snippet in Program.cs file.

//Open the file as Stream
using (FileStream docStream = new FileStream("Data/Template.docx", FileMode.Open, FileAccess.Read))
{
    //Loads an existing Word document
    using (WordDocument wordDocument = new WordDocument(docStream, FormatType.Docx))
    {
        //Instantiation of DocIORenderer for Word to PDF conversion
        using (DocIORenderer render = new DocIORenderer())
        {
            //Converts Word document into PDF document
            using (PdfDocument pdfDocument = render.ConvertToPDF(wordDocument))
            {
                //Create FileStream to save the PDF file.
                using (FileStream outputStream = new FileStream("Result.pdf", FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
                {
                    //Saves the PDF file.
                    pdfDocument.Save(outputStream);
                }
            }
        }
    }
}

Step 5: Execute the following command to restore the NuGet packages.

dotnet restore

Restore the NuGet packages

Step 6: Execute the following command in terminal to run the application.

dotnet run

Run the Applcation

You can download a complete working sample from GitHub.

By executing the program, you will get the PDF as follows. The output will be saved in parallel to program.cs file.

Word to PDF in Linux

Prerequisites:

  • JetBrains Rider.
  • Install .NET 8 SDK or later.

Step 1: Open JetBrains Rider and create a new .NET Core console application project.

  • Launch JetBrains Rider.
  • Click New Solution on the welcome screen.

Launch JetBrains Rider

  • In the New Solution dialog, select Project Type as Console.
  • Select the target framework (e.g., .NET 8.0, .NET 9.0).
  • Enter a project name and specify the location.
  • Click create.

Creating a new .NET Core console application in JetBrains Rider

Step 2: Install the NuGet package from NuGet.org.

  • Click the NuGet icon in the Rider toolbar and type Syncfusion.DocIORenderer.Net.Core in the search bar.
  • Ensure that nuget.org is selected as the package source.
  • Select the latest Syncfusion.DocIORenderer.Net.Core NuGet package from the list.
  • Click the + (Add) button to add the package.

Select the Syncfusion.DocIORenderer.Net.Core NuGet package

  • Click the Install button to complete the installation.

Install the Syncfusion.DocIORenderer.Net.Core NuGet package

NOTE

Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add “Syncfusion.Licensing” assembly reference and include a license key in your projects. Please refer to this link to know about registering Syncfusion license key in your application to use our components.

Step 3: Add the following Namespaces in Program.cs file.

using Syncfusion.DocIO;
using Syncfusion.DocIO.DLS;
using Syncfusion.DocIORenderer;
using Syncfusion.Pdf;

Step 4: Add the following code snippet in Program.cs file.

//Open the file as Stream
using (FileStream docStream = new FileStream("Data/Template.docx", FileMode.Open, FileAccess.Read))
{
    //Loads an existing Word document
    using (WordDocument wordDocument = new WordDocument(docStream, FormatType.Docx))
    {
        //Instantiation of DocIORenderer for Word to PDF conversion
        using (DocIORenderer render = new DocIORenderer())
        {
            //Converts Word document into PDF document
            using (PdfDocument pdfDocument = render.ConvertToPDF(wordDocument))
            {
                //Create FileStream to save the PDF file.
                using (FileStream outputStream = new FileStream("Result.pdf", FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
                {
                    //Saves the PDF file.
                    pdfDocument.Save(outputStream);
                }
            }
        }
    }
}

Step 5: Build the project.

Click the Build button in the toolbar or press Ctrl+Shift+B to build the project.

Step 6: Run the project.

Click the Run button (green arrow) in the toolbar or press F5 to run the app.

You can download a complete working sample from GitHub.

By executing the program, you will get the PDF as follows. The output will be saved in parallel to program.cs file.

Word to PDF in Linux

Click here to explore the rich set of Syncfusion® Word library (DocIO) features.

An online sample link to convert Word document to PDF in ASP.NET Core.

Frequently Asked Questions